Adding general external services¶
You can collect metrics from an external (custom) exporter on a node when:
- there is already a PMM Agent instance running and,
- this node has been configured using the
pmm-admin add external --service-name=<service-name> --listen-port=<listen-port> --metrics-path=<metrics-path> --scheme=<scheme>
pmm-admin add external-serverless --external-name=<external-service-name> --host=<hostname> --listen-port=<listen-port> --metrics-path=<metrics-path> --scheme=<scheme>
Getting data from external exporters¶
There two ways to get metrics from other exporters:
externalwill collect metrics from the exporter that is run on the same host as PMM Client’s connection to it by a port. (See more details with
pmm-admin add external --help.)
external-serverlessis useful for collecting metrics from cloud services. You need a host and port number to add it to PMM Server. (See more details with
pmm-admin add external-serverless --help.)
Here are the differences between
Connection schema of external exporter:
Connection schema of external serverless exporter:
How I can add something not supported by PMM¶
PMM can collect any metrics in Open metrics or Prometheus exposition format. You must specify the host and port of these metrics using the
pmm-admin add external or
pmm-admin add external-serverless commands.
From this point, PMM will collect and store available metrics.
To browse and visualize collected metrics as a first step, we can look at the Advanced Data Exploration dashboard and select informative services and metrics.
Another way is to create a new Grafana Dashboard to PMM as needed.
One more way is to search for an already created dashboard at https://grafana.com/grafana/dashboards for the added exporter and import it into PMM.
You can find more exporters on the official Prometheus page.
You can write a custom external exporter or extend your application to expose metrics in Prometheus format.
Please see more details here: https://prometheus.io/docs/instrumenting/writing_exporters/
root@mysql1:~# pmm-admin add external --group=processess --listen-port=9256 External Service added. Service ID : /service_id/6485f4fd-745b-4dfb-8b72-328e300f8b50 Service name: mysql1-processess Group : processess
- Page updated 2021-04-02