Skip to content

Commit 06ffa93

Browse files
authored
Update instructions with Datadog Agent source and Cloudprem dest (#33314)
1 parent 1f53b0b commit 06ffa93

File tree

1 file changed

+34
-19
lines changed

1 file changed

+34
-19
lines changed

content/en/cloudprem/ingest_logs/observability_pipelines.md

Lines changed: 34 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -11,6 +11,9 @@ further_reading:
1111
- link: "/observability_pipelines/"
1212
tag: "Documentation"
1313
text: "Observability Pipelines Overview"
14+
- link: "/observability_pipelines/destinations/cloudprem/"
15+
tag: "Documentation"
16+
text: "CloudPrem Destination for Observability Pipelines"
1417
---
1518

1619
{{< callout url="https://www.datadoghq.com/product-preview/cloudprem/" btn_hidden="false" header="CloudPrem is in Preview" >}}
@@ -19,42 +22,48 @@ further_reading:
1922

2023
## Overview
2124

22-
You can send logs to CloudPrem using Observability Pipelines with the following setup:
23-
- Datadog Agent collects logs and send them to Observability Pipelines HTTP server source.
24-
- Observability Pipelines forwards logs to the HTTP client destination.
25+
Observability Pipelines provides a flexible intermediary layer between your Datadog Agents and CloudPrem, allowing you to process, transform, and route logs before they reach your CloudPrem deployment. Configure Observability Pipelines to receive logs from the Datadog Agent and forward them to CloudPrem:
26+
1. [**Create and configure the pipeline**](#create-and-configure-an-observability-pipeline) - Define your pipeline configuration (source, processors, destination) in the Observability Pipelines UI. This creates the pipeline definition that will be used by the Worker.
27+
2. [**Deploy the Observability Pipelines Worker**](##deploy-your-observability-pipelines) - Install the Worker with your pipeline configuration. The Worker must be running and listening for logs before the Agent can connect to it.
28+
3. [**Configure the Datadog Agent**](#configure-the-datadog-agent) - Point the Agent to send logs to the deployed Worker. This step must come last because the Agent needs the Worker's address to be available.
2529

2630
## Create and configure an Observability Pipeline
2731

28-
You'll need to create a pipeline that acts as an intermediary for your logs. Navigate to the [Observability Pipelines][1] page and create a pipeline using the **Log Volume Control** template. Configure the pipeline with the following components:
29-
- **HTTP server source**: (No configuration) This is the entry point where the Datadog Agent will send logs. Leave the configuration empty.
30-
- **Empty processor**: Remove all default processors from the pipeline.
31-
- **HTTP client destination**: (No configuration) This forwards the logs to your CloudPrem instance. Leave the configuration empty.
32-
33-
After configuring, your pipeline should look like this and you are ready to deploy:
32+
1. Navigate to [Observability Pipelines][1].
33+
1. Select the [**Log Volume Control template**][2].
34+
1. Set up your pipeline:
35+
1. Choose the [**Datadog Agent** source][3].
36+
1. Remove any default processors from the pipeline.
37+
1. Select the [**Datadog CloudPrem** destination][4] to forward logs to your CloudPrem instance. Leave the configuration empty.
3438

35-
{{< img src="/cloudprem/ingest/observability-pipelines-cloudprem-setup.png" alt="Screenshot of the Logs Explorer interface showing how to filter logs by selecting the cloudprem index in the facets panel" style="width:80%;" >}}
39+
<!-- This image shows an example with dual shipping when the instructions say log volume control -->
40+
<!-- {{< img src="/cloudprem/ingest/observability-pipelines-cloudprem-setup.png" alt="Screenshot of the Logs Explorer interface showing how to filter logs by selecting the cloudprem index in the facets panel" style="width:80%;" >}} -->
3641

3742

3843
## Deploy your Observability Pipelines
3944

40-
While other methods exist, this guide uses the Helm command for deployment. The following command installs or upgrades the pipeline, configuring it to listen for logs and forward them to your CloudPrem indexer.
45+
After creating your pipeline in the UI, deploy the Observability Pipelines Worker. The Worker runs your pipeline configuration and listens for logs from the Datadog Agent.
46+
47+
The following Helm command installs or upgrades the Worker, configuring it to listen for logs and forward them to your CloudPrem indexer.
48+
<br>
49+
**Note**: You need the `pipelineId` from the pipeline you created in the previous step. This ID links the Worker to your pipeline configuration.
4150

4251
```shell
4352
helm upgrade --install opw \
4453
-f values.yaml \
4554
--set datadog.apiKey=XXXXXXX \
4655
--set datadog.pipelineId=XXXXXXX \
47-
--set env[0].name=DD_OP_SOURCE_HTTP_SERVER_ADDRESS,env[0].value='0.0.0.0:8282' \
48-
--set env[1].name=DD_OP_DESTINATION_HTTP_CLIENT_URI,env[1].value='http://<RELEASE_NAME>-indexer.<NAMESPACE_NAME>.svc.cluster.local:7280/api/v2/datadog' \
49-
--set service.ports[0].name=dd-op-source-http-server-address-port,service.ports[0].protocol=TCP,service.ports[0].port=8282,service.ports[0].targetPort=8282 \
56+
--set env[0].name=DD_OP_SOURCE_DATADOG_AGENT_ADDRESS,env[0].value='0.0.0.0:8282' \
57+
--set env[1].name=DD_OP_DESTINATION_CLOUDPREM_ENDPOINT_URL,env[1].value='http://<RELEASE_NAME>-indexer.<NAMESPACE_NAME>.svc.cluster.local:7280' \
58+
--set service.ports[0].name=dd-op-source-datadog-agent-address-port,service.ports[0].protocol=TCP,service.ports[0].port=8282,service.ports[0].targetPort=8282 \
5059
datadog/observability-pipelines-worker
5160
```
5261

53-
After a minute, you should see logs flowing through the pipelines and successfully reach the CloudPrem destination.
62+
After a minute, verify that logs are flowing through the pipeline and reaching the CloudPrem destination. This indicates that the Worker is running and ready to receive logs, and you can proceed to configure the Agent.
5463

55-
## Configure Datadog Agent
64+
## Configure the Datadog Agent
5665

57-
The final step is to update your Datadog Agent's configuration to point its logs to the newly deployed Observability Pipelines worker. You do this by setting the `DD_LOGS_CONFIG_LOGS_DD_URL` environment variable to the pipeline's address.
66+
After the Observability Pipelines Worker is deployed and running, configure your Datadog Agent to send logs to it. The Agent connects to the Worker using the Worker's service address. For more information, see [Connect the Datadog Agent to the Observability Pipelines Worker][5].
5867

5968
Update your Datadog Agent configuration to send logs to the Observability Pipelines worker:
6069

@@ -72,8 +81,10 @@ spec:
7281
secretName: datadog-secret
7382
keyName: api-key
7483
env:
75-
- name: DD_LOGS_CONFIG_LOGS_DD_URL
76-
value: http://observability-pipelines-worker:8282
84+
- name: DD_OBSERVABILITY_PIPELINES_WORKER_LOGS_ENABLED
85+
value: "true"
86+
- name: DD_OBSERVABILITY_PIPELINES_WORKER_LOGS_URL
87+
value: "http://observability-pipelines-worker:8282"
7788

7889
features:
7990
logCollection:
@@ -101,3 +112,7 @@ kubectl exec -it <RELEASE_NAME>-searcher-0 -n <NAMESPACE_NAME> -- curl 'http://l
101112
{{< partial name="whats-next/whats-next.html" >}}
102113

103114
[1]: https://app.datadoghq.com/observability-pipelines
115+
[2]: /observability_pipelines/configuration/explore_templates/?tab=logs#log-volume-control
116+
[3]: /observability_pipelines/sources/datadog_agent/
117+
[4]: /observability_pipelines/destinations/cloudprem/
118+
[5]: /observability_pipelines/sources/datadog_agent/?tab=agenthelmvaluesfile#connect-the-datadog-agent-to-the-observability-pipelines-worker

0 commit comments

Comments
 (0)