Skip to content

Commit b38d5ce

Browse files
[DOCS-11538] Add enable liveness and readiness probe (#30810)
* add info * Apply suggestions from code review Co-authored-by: Alicia Scott <[email protected]> --------- Co-authored-by: Alicia Scott <[email protected]>
1 parent 5c1df3b commit b38d5ce

File tree

2 files changed

+15
-5
lines changed

2 files changed

+15
-5
lines changed

content/en/observability_pipelines/advanced_configurations.md

Lines changed: 13 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -26,7 +26,7 @@ further_reading:
2626

2727
## Overview
2828

29-
This document explains bootstrapping for the Observability Pipelines Worker.
29+
This document explains [bootstrapping](#bootstrap-options) for the Observability Pipelines Worker and how to [enable the liveness and readiness probe](#enable-liveness-and-readiness-probe).
3030

3131
## Bootstrap Options
3232

@@ -54,9 +54,8 @@ The following is a list of bootstrap options, their related pipeline environment
5454
: An example configuration:
5555
: &nbsp;&nbsp;&nbsp;&nbsp;`api`:<br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;`enabled`: `true`<br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;`address`: `"127.0.0.1:8686" # optional`
5656
: Note: Setting `address` is optional. It is the network address to which the API should bind. If you're running the Worker in a Docker container, bind to `0.0.0.0`. Otherwise, the API is not exposed outside of the container.
57-
: **Description**: Enable the Observability Pipelines Worker API so you can see the Worker's processes with the `tap` or `top` command. See [Run, tap, or top the Worker][8] for more information. If you are using the Helm charts provided when you [set up a pipeline][7], then the API has already been enabled. Otherwise, make sure the environment variable `DD_OP_API_ENABLED` is set to `true` in `/etc/observability-pipelines-worker/bootstrap.yaml`, which:
58-
: - Sets up the API to listen on `localhost` and port `8686`, which is what the CLI for `tap` is expecting.
59-
: - Exposes the `/health` endpoint. Configure a load balancer's health check with the `/health` endpoint to check that the Worker is up and running.
57+
: **Description**: Enable the Observability Pipelines Worker API so you can see the Worker's processes with the `tap` or `top` command. See [Run, tap, or top the Worker][8] for more information. If you are using the Helm charts provided when you [set up a pipeline][7], then the API has already been enabled. Otherwise, make sure the environment variable `DD_OP_API_ENABLED` is set to `true` in `/etc/observability-pipelines-worker/bootstrap.yaml`. This sets up the API to listen on `localhost` and port `8686`, which is what the CLI for `tap` is expecting.
58+
<br><br>See [Enable liveness and readiness probe](#enable-liveness-and-readiness-probe) on how to expose the `/health` endpoint.
6059

6160
`api_key`
6261
: **Pipeline environment variable**: `DD_API_KEY`
@@ -105,6 +104,16 @@ The following is a list of bootstrap options, their related pipeline environment
105104
: <li style="list-style-type: '- '">The Observability Pipelines Worker cannot route external requests through reverse proxies, such as HAProxy and NGINX.</li>
106105
: <li style="list-style-type: '- '">The <code>DD_PROXY_HTTP(S)</code> and <code>HTTP(S)_PROXY</code> environment variables need to be already exported in your environment for the Worker to resolve them. They cannot be prepended to the Worker installation script.</li>
107106

107+
## Enable liveness and readiness probe
108+
109+
Configure your load balancer's health check with the `/heath` endpoint to check that the Worker is up and running. To expose the `/health` endpoint, you must set `DD_OP_API_ENABLED` to `true` and set the `DD_OP_API_ADDRESS` to `0.0.0.0:8686`. An example configuration:
110+
111+
```
112+
api:
113+
enabled: true
114+
address: "0.0.0.0.1:8686"
115+
```
116+
108117
## Further reading
109118

110119
{{< partial name="whats-next/whats-next.html" >}}

content/en/observability_pipelines/troubleshooting.md

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -25,7 +25,7 @@ If you can access your Observability Pipelines Workers locally, use the `tap` co
2525

2626
The Observability Pipelines Worker API allows you to interact with the Worker's processes with the `tap` and `top` command. If you are using the Helm charts provided when you [set up a pipeline][4], then the API has already been enabled. Otherwise, make sure the environment variable `DD_OP_API_ENABLED` is set to `true` in `/etc/observability-pipelines-worker/bootstrap.yaml`. See [Bootstrap options][5] for more information. This sets up the API to listen on `localhost` and port `8686`, which is what the CLI for `tap` is expecting.
2727

28-
**Note**: When `DD_OP_API_ENABLED` is set to `true`, the `/health` endpoint is also exposed. Configure load balancers to use the `/health` API endpoint to check that the Worker is up and running.
28+
**Note**: See [Enable liveness and readiness probe][15] for instructions on how to expose the `/health` endpoint. After the endpoint is exposed, configure load balancers to use the `/health` API endpoint to check that the Worker is up and running.
2929

3030
### Use `top` to find the component ID
3131

@@ -143,3 +143,4 @@ If the Worker is not starting, Worker logs are not sent to Datadog and are not v
143143
[12]: https://app.datadoghq.com/logs
144144
[13]: /observability_pipelines/install_the_worker/worker_commands/
145145
[14]: https://docs.redhat.com/en/documentation/red_hat_enterprise_linux/7/html/security_guide/sec-port_forwarding#sec-Adding_a_Port_to_Redirect
146+
[15]: /observability_pipelines/advanced_configurations/#enable-liveness-and-readiness-probe

0 commit comments

Comments
 (0)