You can send metrics from anywhere as long as you can reach the Prometheus endpoint.

You can find some examples to configure available metric sources with Prometheus.

FluentBit

This repository provides a basic example of how to configure FluentBit to send metrics to the IONOS Monitoring Service.

Provision a pipeline

Provision a monitoring pipeline using REST API https://monitoring.de-txl.ionos.com/pipelines.

Example API Request Body

{
  "properties": {
    "name": "example"
  }
}

Usage

1. Grab the key from the above response or provision a new key using REST API https://monitoring.de-txl.ionos.com/pipelines/<PIPELINE_ID>/key.

2. Install FluentBit package, appropriate for your distribution.

3. Update the HTTP endpoint and the APIKEY in the fluentbit.conf file.

4. Configure FluentBit to your desired state.

5. Run FluentBit and Profit.

Grafana Agent

This example shows how to configure Grafana Agent to send metrics to the monitoring pipeline.

Provision a pipeline

Provision a monitoring pipeline using REST API https://monitoring.de-txl.ionos.com/pipelines.

Example API Request Body

{
  "properties": {
    "name": "example"
  }
}

Usage `

1. Grab the key from the above response or provision a new key using REST API https://monitoring.de-txl.ionos.com/pipelines/<PIPELINE_ID>/key.

2. Install Grafana Agent package, appropriate for your distribution. (https://grafana.com/docs/agent/latest/about/)

3. Update the HTTP endpoint and the APIKEY in the config file.

  prometheus.remote_write "LABEL" {
    endpoint {
      url = "your pipeline's httpEndpoint"

      headers = {
        "APIKEY" = "<API_KEY>",
      }
  }
}

Prometheus

Prometheus is a monitoring and alerting toolkit that is designed for reliability and scalability. It is a pull-based system that scrapes metrics from instrumented jobs, either directly or via an intermediary push gateway for short-lived jobs. It stores all scraped samples locally and runs rules over this data to either aggregate and record new time series from existing data or generate alerts.

Provision a pipeline

Provision a monitoring pipeline using REST API https://monitoring.de-txl.ionos.com/pipelines.

Example API Request Body

{
  "properties": {
    "name": "example"
  }
}

Usage

1. Grab the key from the above response or provision a new key using REST API https://monitoring.de-txl.ionos.com/pipelines/<PIPELINE_ID>/key.

2. Install Prometheus package, appropriate for your distribution.

3. Update the HTTP endpoint and the APIKEY in the prometheus config file.

url: "your pipeline's httpEndpoint"
headers:
  APIKEY: "<APIKEY>"

OpenTelemetry

OpenTelemetry is a set of APIs, libraries, agents, and instrumentation to provide observability for cloud-native software. It is a CNCF project.

Provision a pipeline

Provision a monitoring pipeline using REST API https://monitoring.de-txl.ionos.com/pipelines.

Example API Request Body

{
  "properties": {
    "name": "example"
  }
}

Usage

1. Grab the key from the above response or provision a new key using REST API https://monitoring.de-txl.ionos.com/pipelines/<PIPELINE_ID>/key.

2. Update the HTTP endpoint and the APIKEY in the config file.

exporters:
  prometheusremotewrite:
    endpoint: "your pipeline's httpEndpoint"
    external_labels:
      APIKEY: <API_KEY>
      label_name2: label_value2

An observability platform is necessary for visualization and reporting purposes. IONOS uses Grafana to enable you to meet your visualization needs.

Grafana access for sub-users

Sub-users in your contract number can access Grafana with their IONOS credentials, subject to the following conditions:

• At least one pipeline must be connected to the contract number.

• Sub-users must be active and have the Privileges to access Monitoring Service.

If you are unable to log into Grafana, ensure that you have checked the following:

• The sub-user is active and has the necessary privileges to access the Monitoring Service.

• The contract number contains at least one monitoring pipeline.

• The sub-user uses the correct email address associated with the contract number.

If the issue persists, contact IONOS Cloud Support.

You can obtain your Grafana instance address by sending a GET request to the server. For more information, see Retrieve Monitoring Pipeline Information. The response contains the grafanaEndpoint. This information remains the same for all your monitoring pipelines.

After creating a monitoring pipeline via the REST API, complete the monitoring pipeline configuration process using the following: