{ "componentChunkName": "component---src-templates-issues-tsx", "path": "/issues/438", "result": {"data":{"issuesJson":{"id":"fb33c5ad-88bc-5aec-9a12-b750ff62ea81","title":"czerwonk/ping_exporter: Ping 指标的 Prometheus Exporter","number":438,"bodyHTML":"
\n



\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
Reposczerwonk/ping_exporter
Views\"views\"
Stars\"stars\"
Forks\"forks\"
License\"license\"
UpdatedAt\"last-commit\"
CreatedAt\"create-at\"
\n\n

\"\"

\n\n
\n

ping_exporter

\n

\"Go

\n

Prometheus exporter for ICMP echo requests using https://github.com/digineo/go-ping

\n

This is a simple server that scrapes go-ping stats and exports them via HTTP for
\nPrometheus consumption. The go-ping library is build and maintained by Digineo GmbH.
\nFor more information check the source code.

\n

Getting Started

\n

Config file

\n

Targets can be specified in a YAML based config file:

\n
targets:\n  - 8.8.8.8\n  - 8.8.4.4\n  - 2001:4860:4860::8888\n  - 2001:4860:4860::8844\n  - google.com:\n      asn: 15169\n\ndns:\n  refresh: 2m15s\n  nameserver: 1.1.1.1\n\nping:\n  interval: 2s\n  timeout: 3s\n  history-size: 42\n  payload-size: 120\n\noptions:\n  disableIPv6: false
\n

Note: domains are resolved (regularly) to their corresponding A and AAAA
\nrecords (IPv4 and IPv6). By default, ping_exporter uses the system
\nresolver to translate domain names to IP addresses. You can override the
\nresolver address by specifying the --dns.nameserver flag when starting
\nthe binary, e.g.

\n
$ # use Cloudflare's public DNS server\n$ ./ping_exporter --dns.nameserver=1.1.1.1:53 [other options]
\n

The configuration file is watched via inotify. If the configuration is changed,
\nping_exporter will update the targets. To change any global options like the ping
\ninterval or history size, you must restart the exporter.

\n

Exported metrics

\n\n

Each metric has labels ip (the target's IP address), ip_version
\n(4 or 6, corresponding to the IP version), and target (the target's
\nname).

\n

Additionally, a ping_up metric reports whether the exporter
\nis running (and in which version).

\n

Shell

\n

To run the exporter:

\n
$ ./ping_exporter [options] target1 target2 ...
\n

or

\n
$ ./ping_exporter --config.path my-config-file [options]
\n

Help on flags:

\n
$ ./ping_exporter --help
\n

Getting the results for testing via cURL:

\n
$ curl http://localhost:9427/metrics
\n

Running as non-root user

\n

On Linux systems CAP_NET_RAW is required to run ping_exporter as unpriviliged user.

\n
# setcap cap_net_raw+ep /path/to/ping_exporter
\n

When run through a rootless Docker implementation on Linux, the flag --cap-add=CAP_NET_RAW should be added to the docker run invocation.

\n

If being invoked via systemd, you can alternately just add the following
\nsettings to the service's unit file in the [Service] section:

\n
CapabilityBoundingSet=CAP_NET_RAW\nAmbientCapabilities=CAP_NET_RAW
\n

Docker

\n

https://hub.docker.com/r/czerwonk/ping_exporter

\n

To run the ping_exporter as a Docker container, run:

\n
$ docker run -p 9427:9427 -v /path/to/config/directory:/config:ro --name ping_exporter czerwonk/ping_exporter
\n

Kubernetes

\n

To run the ping_exporter in Kubernetes, you can use the supplied helm chart

\n

Prerequisites

\n\n

Installing the chart

\n

To install the chart with the release name ping-exporter:

\n
$ helm repo add ping-exporter \"https://raw.githubusercontent.com/czerwonk/ping_exporter/main/dist/charts/\"\n\"ping-exporter\" has been added to your repositories\n\n$ helm repo update\nHang tight while we grab the latest from your chart repositories...\n...Successfully got an update from the \"ping-exporter\" chart repository\nUpdate Complete. ⎈Happy Helming!⎈\n\n$ helm install ping-exporter ping-exporter/ping-exporter\nNAME: ping-exporter\n...\n
\n

General parameters

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
KeyTypeDefaultDescription
affinityobject{}Affinity
argslist[]Add additional command-line arguments when running ping_exporter
configobjectsee values.yamlContains the contents of ping_exporter's config file
fullnameOverridestring\"\"String to fully override \"ping-exporter.fullname\"
image.repositorystring\"czerwonk/ping_exporter\"String to override the docker image repository
image.pullPolicystring\"IfNotPresent\"String to override the pullPolicy
image.tagstring\"\"Overrides the ping_exporter image tag whose default is the chart appVersion
imagePullSecretslist[]If defined, uses a secret to pull an image from a private Docker registry or repository
ingress.enabledboolfalseEnable an ingress resource for the ping_exporter
ingress.classNamestring\"\"Defines which ingress controller will implement the resource
ingress.annotationsobject{}Annotations to be added to the ingress resource
ingress.hostslist[{\"host\": \"chart-example.local\", \"paths\":[{\"path\": \"/\", \"pathType\": \"ImplementationSpecific\"}]}]Defines the ingress hosts and path to proxy
ingress.tlslist[]Defines the secret(s) containing TLS certs for the ingress host
nameOverridestring\"\"Provide a name in place of ping-exporter
podAnnotationsobject{}Annotations to be added to ping_exporter pods
podSecurityContextobject{}Sets the container-level security context
replicaCountnumber1Override the number of replicas running
resourcesobject{}Defines the ping_exporter pod's resource cpu/memory limits and requests
nodeSelectorobject{}Node selector
securityContext.capabilitiesobject{\"add\": [\"CAP_NET_RAW\"]}This object overrided the pod's security context capabilities
service.typestring\"ClusterIP\"Sets the type of kubernetes service which is created for ping_exporter
service.portnumber9427Sets the port in which the kubernetes service will listen on and communicate with the ping_exporter pod
service.annotationsobject{}Annotations applied to the kubernetes service
serviceAccount.createbooltrueCreate a service account for the application
serviceAccount.annotationsobject{}Annotations applied to created service account
serviceAccount.namestring\"\"Overrides the application's service account name which defaults to \"ping-exporter.fullname\"
tolerationslist[]Tolerations
testConnection.enabledbooltrueEnable the test connection pod for the ping_exporter
\n

Changes from previous versions

\n

ping_loss_ratio vs ping_loss_percent

\n

Previous versions of the exporter reported packet loss via a metric named
\nping_loss_percent. This was somewhat misleading / wrong, because it never
\nactually reported a percent value (it was always a value between 0 and 1). To
\nmake this more clear, and to match with Prometheus best
\npractices, this
\nmetric has been renamed to ping_loss_ratio instead.

\n

If you had already been using an earlier version and want to continue to record
\nthis metric in Prometheus using the old name, this can be done using the
\nmetric_relabel_configs options in the Prometheus config, like so:

\n
- job_name: \"ping\"\n  static_configs:\n    <...>\n  metric_relabel_configs:\n    - source_labels: [__name__]\n      regex: \"ping_loss_ratio\"\n      target_label: __name__\n      replacement: \"ping_loss_percent\"
\n

Time units

\n

As per the recommendations for Prometheus best
\npractices, the
\nexporter reports time values in seconds by default. Previous versions
\ndefaulted to reporting milliseconds by default (with metric names ending in
\n_ms instead of _seconds), so if you are upgrading from an older version,
\nthis may require some adjustment.

\n

It is possible to change the ping exporter to report times in milliseconds
\ninstead (this is not recommended, but may be useful for compatibility with
\nolder versions, etc). To do this, the metrics.rttunit command-line switch
\ncan be used:

\n
$ # keep using seconds (default)\n$ ./ping_exporter --metrics.rttunit=s [other options]\n$ # use milliseconds instead\n$ ./ping_exporter --metrics.rttunit=ms [other options]\n$ # report both millis and seconds\n$ ./ping_exporter --metrics.rttunit=both [other options]
\n

If you used the ping_exporter in the past, and want to migrate, start
\nusing --metrics.rttunit=both now. This gives you the opportunity to
\nupdate all your alerts, dashboards, and other software depending on ms
\nvalues to use proper scale (you \"just\" need to apply a factor of 1000
\non everything). When you're ready, you just need to switch to
\n--metrics.rttunit=s (or just remove the command-line option entirely).

\n

Deprecated metrics

\n

Previous versions of this exporter provided an older form of the RTT metrics
\nas:

\n\n

This metric had a label type with one of the following values:

\n\n

These metrics are no longer exported by default, but can be enabled for
\nbackwards compatibility using the --metrics.deprecated command-line flag:

\n
$ # also export deprecated metrics\n$ ./ping_exporter --metrics.deprecated=enable [other options]\n$ # or omit deprecated metrics (default)\n$ ./ping_exporter --metrics.deprecated=disable [other options]
\n

Contribute

\n

Simply fork and create a pull-request. We'll try to respond in a timely fashion.

\n

License

\n

MIT License, Copyright (c) 2018
\nPhilip Berndroth pberndro
\nDaniel Czerwonk dan_nrw

","updatedAt":"2025-05-21T16:15:57Z","upvoteCount":null,"author":{"login":"eryajf","avatarUrl":"https://avatars.githubusercontent.com/u/33259379?u=e4a4090a38ac2473aaed4ef9945233636776c6c3&v=4","url":"https://github.com/eryajf"},"category":null,"labels":{"edges":[{"node":{"name":"更多","color":"25B472"}},{"node":{"name":"Prometheus-Exporter","color":"367acb"}},{"node":{"name":"czerwonk","color":"1b9bcc"}}]},"comments":{"edges":[]}}},"pageContext":{"number":438,"previous":{"title":"OpenAtomFoundation/pika: Pika 是一个以 RocksDB 为存储引擎的的大容量、高性能、多租户、数据可持久化的弹性 KV 数据存储系统，完全兼容 Redis 协议，支持其常用的数据结构。","number":437},"next":{"title":"pinpoint-apm/pinpoint: APM，（应用程序性能管理）大规模分布式系统的工具。","number":439}}}, "staticQueryHashes": ["151096407","2861350382"]}