Send Metrics to the Platform
You can send metrics to the Monitoring Service using agents such as Fluent Bit, Grafana Agent, Prometheus, and OpenTelemetry Collector.
This Quickstart shows how to create a pipeline, get an API key, and configure one of these agents.
Prerequisites
An IONOS account with permissions to create monitoring pipelines.
Outbound
HTTPSaccess on port 443.The required agent or collector must be installed on your system.
Example endpoint:
123456789-metrics.987654321.monitoring.de-txl.ionos.com
You can also find Prometheus configuration examples in our GitHub repository.
API key usage
Use the API Key returned when you created the pipeline for authentication.
You only need to generate a new one in specific cases, such as:
The key was accidentally shared
The key was lost
A team member with access left the company
To generate a new API key, run:
curl -X POST "https://monitoring.de-txl.ionos.com/pipelines/<PIPELINE_ID>/key"This will issue a new API Key and replace the previous one.
The final endpoint for sending metrics is:
https://<HTTP_ENDPOINT>/api/v1/pushConfigure an agent
Each agent requires the pipeline httpEndpoint and API key.
This example shows how to configure Fluent Bit to send metrics to the Monitoring Service.
Install the Fluent Bit package for your distribution.
Update the
fluentbit.conffile with theHTTP endpointandAPI key.Run Fluent Bit.
Check the logs to confirm metrics are sent.
[OUTPUT]
Name http
Match *
Host <pipeline-endpoint-host>
Port 443
URI /
Header Authorization Bearer <apiKey>
Format jsonYou can configure Grafana Agent to send metrics to the monitoring pipeline.
Install the Grafana Agent package for your distribution. For more information, refer to the Grafana Documentation.
Update the HTTP endpoint and API key in the configuration file.
prometheus.remote_write "LABEL" {
endpoint {
url = "your pipeline's httpEndpoint"
headers = {
"APIKEY" = "<API_KEY>",
}
}
}Prometheus is a monitoring and alerting toolkit designed for reliability and scalability. It is a pull-based system that scrapes metrics from instrumented jobs, either directly or through a push gateway for short-lived jobs.
Install the Prometheus package for your distribution.
Update the
prometheus.ymlfile with theHTTP endpointandAPI key.
url: "your pipeline's httpEndpoint"
headers:
APIKEY: "<APIKEY>"OpenTelemetry is a set of APIs, libraries, agents, and instrumentation for observability. It is a Cloud Native Computing Foundation (CNCF).
Install the OpenTelemetry Collector.
Update the configuration file with the
HTTP endpointandAPI key.
exporters:
prometheusremotewrite:
endpoint: "your pipeline's httpEndpoint"
external_labels:
APIKEY: <API_KEY>
label_name2: label_value2Troubleshooting
Verify: Open the Monitoring Service dashboard and confirm that metrics appear.
Invalid API key: Check that you copied the correct key.
Connection errors: Verify outbound
HTTPSaccess on port 443.No metrics displayed: Confirm that the agent is running and producing data.
Last updated
Was this helpful?