Skip to main content Link Search Menu Expand Document (external link)

Ping7.io documentation

This documentation provides a quick start and comprehensive insights in configuring and using the ping7.io managed prometheus exporters. Learn how to gather valuable metrics from multiple outside check locations.

Schema

Getting started

To get started you need:

  • a working Prometheus installation and access to its configuration. This can be either a local Docker container, a SaaS Prometheus offering or a system installed on a server.
  • A ping7.io account and a api token.

💡 We recommend that you start experimenting with a local Docker container to get started

Quick start: Use example repo

We have provided you with an example Prometheus configuration repository that contains some examples how to integrate our exporters easily into your Promtheus configuration. For the example to run, you need Docker installed.

  1. Clone our example repository
$ git clone https://github.com/ping7io/examples.git
$ cd examples
  1. Provide ping7.io api token

Create a file named ping7io-credentials that contains your ping7.io api token.

$ echo "YOUR_API_TOKEN" > ping7io-credentials

The file is later picked up by Prometheus as a secret.

  1. Start a local Prometheus

The local Prometheus will instantly start collecting availability metrics for the ping7.io and prometheus.io websites.

$ docker compose up

Learn how to query and analyze metrics in Prometheus in the example repository

Configure your own Prometheus instance

If you have an already preconfigured Prometheus