2019-02-26 13:50:07 +00:00
|
|
|
# Ping
|
|
|
|
|
|
|
|
Checking the Health of Your Traefik Instances
|
|
|
|
{: .subtitle }
|
|
|
|
|
|
|
|
## Configuration Examples
|
|
|
|
|
|
|
|
??? example "Enabling /ping on the http EntryPoint"
|
|
|
|
|
|
|
|
```toml
|
2019-03-14 08:30:04 +00:00
|
|
|
[entrypoints]
|
|
|
|
[entrypoints.web]
|
2019-02-26 13:50:07 +00:00
|
|
|
address = ":80"
|
|
|
|
|
|
|
|
[ping]
|
|
|
|
entryPoint = "http"
|
|
|
|
```
|
|
|
|
|
|
|
|
??? example "Enabling /ping on the https EntryPoint"
|
|
|
|
|
|
|
|
```toml
|
2019-03-14 08:30:04 +00:00
|
|
|
[entrypoints]
|
|
|
|
[entrypoints.web]
|
2019-02-26 13:50:07 +00:00
|
|
|
address = ":80"
|
|
|
|
|
2019-03-14 08:30:04 +00:00
|
|
|
[entrypoints.web-secure]
|
2019-02-26 13:50:07 +00:00
|
|
|
address = ":443"
|
2019-03-14 08:30:04 +00:00
|
|
|
[entrypoints.web-secure.tls]
|
2019-02-26 13:50:07 +00:00
|
|
|
|
|
|
|
[ping]
|
|
|
|
entryPoint = "https"
|
|
|
|
```
|
|
|
|
|
|
|
|
??? example "Enabling /ping on a dedicated EntryPoint"
|
|
|
|
|
|
|
|
```toml
|
2019-03-14 08:30:04 +00:00
|
|
|
[entrypoints]
|
|
|
|
[entrypoints.web]
|
2019-02-26 13:50:07 +00:00
|
|
|
address = ":80"
|
|
|
|
|
2019-03-14 08:30:04 +00:00
|
|
|
[entrypoints.ping]
|
2019-02-26 13:50:07 +00:00
|
|
|
address = ":8082"
|
|
|
|
|
|
|
|
[ping]
|
|
|
|
entryPoint = "ping"
|
|
|
|
```
|
|
|
|
|
|
|
|
| Path | Method | Description |
|
|
|
|
|---------|---------------|----------------------------------------------------------------------------------------------------|
|
|
|
|
| `/ping` | `GET`, `HEAD` | A simple endpoint to check for Traefik process liveness. Return a code `200` with the content: `OK` |
|
|
|
|
|
|
|
|
## Configuration Options
|
|
|
|
|
|
|
|
The `/ping` health-check URL is enabled with the command-line `--ping` or config file option `[ping]`.
|
|
|
|
|
|
|
|
You can customize the `entryPoint` where the `/ping` is active with the `entryPoint` option (default value: `traefik`)
|