[DOCS-12091] OP Route to multiple DD orgs

content/en/observability_pipelines/configuration/set_up_pipelines.md

@@ -90,7 +90,6 @@ To delete a destination, click on the pencil icon to the top right of the destin
 
 - A pipeline must have at least one destination. If a processor group only has one destination, that destination cannot be deleted.
 - You can add a total of three destinations for a pipeline.
-- A specific destination can only be added once. For example, you cannot add multiple Splunk HEC destinations.
 
 [1]: /observability_pipelines/sources/
 [2]: /observability_pipelines/processors/

content/en/observability_pipelines/destinations/datadog_logs.md

@@ -16,11 +16,48 @@
 
 ### Set up the destination
 
-1. Optionally, toggle the switch to enable **Buffering Options**.<br>**Note**: Buffering options is in Preview. Contact your account manager to request access.
-	- If left disabled, the maximum size for buffering is 500 events.
-	- If enabled:
-		1. Select the buffer type you want to set (**Memory** or **Disk**).
-		1. Enter the buffer size and select the unit.
+There are no required setup steps.
+
+#### Optional settings
+
+##### Route logs to multiple Datadog organizations
+
+You can route logs to multiple Datadog organizations. After routing has been set up, you can [view metrics for the component or specific organizations](#view-metrics-for-the-component-or-specific-organizations) to which you are routing logs.
+
+**Note**: You can route up to 100 Datadog organizations.
+
+{{< img src="observability_pipelines/destinations/multi_dd_orgs.png" alt="The Datadog Logs destination showing us1 and us3 org" style="width:45%;" >}}
+
+Click **Route to Multiple Organizations** to set up routing to multiple Datadog organizations.
+
+- If you haven't added any organizations yet, enter organization details as described in the [Add a Datadog organization](#add-an-organization) section.
+- If you have already added organizations, you can:
+  - Click on an organization in the table to edit or delete it.
+  - Use the search bar to find a specific organization by name, filter query, or Datadog site, and then select the organization to edit or delete it.
+  - [View metrics](#view-metrics-for-the-component-or-specific-organizations) for an organization.
+  - Click **Add organization** to route to another Datadog organization.
+
+**Note**: If you don't set up routing to multiple Datadog organizations, logs are routed to the default Datadog organization, which is the organization that is tied to the API key when you install the Worker.
+
+##### Add an organization
+
+<div class="alert alert-warning">Logs that do not match any of the organization filters are dropped. The <a href="#component-level-metrics">component metric</a> <code>Data dropped (intentional)</code> shows the number logs that do not match the filters and are dropped.</div>
+
+1. Enter a name for the organization.
+	- **Note**: The name does not have to correspond to the actual name of the Datadog organization.
+1. Define a filter query. Only logs that match the specified filter query are sent to the organization. See [Observability Pipelines Search Syntax][3] for more information on writing filter queries.
+1. Select the Datadog organization's site.
+1. Enter the identifier for the API key for that Datadog organization.
+	- **Note**: Only enter the identifier for the API key. Do **not** enter the actual API key.
+1. Click **Save**.
+
+##### Buffering options
+
+Toggle the switch to enable **Buffering Options**.<br>**Note**: Buffering options is in Preview. Contact your account manager to request access.
+- If left disabled, the maximum size for buffering is 500 events.
+- If enabled:
+	1. Select the buffer type you want to set (**Memory** or **Disk**).
+	1. Enter the buffer size and select the unit.
 
 ### Set secrets
 
@@ -40,6 +77,33 @@
 {{% /tab %}}
 {{< /tabs >}}
 
+## View metrics for the component or specific organizations
+
+You can view metrics at the [component level](#component-level-metrics) or [organization level](#organization-level-metrics).
+
+### Component-level metrics
+
+To view metrics for the overall Datadog Logs destination:
+
+1. Navigate to [Observability Pipelines][1].
+1. Select your pipeline.
+1. Click the cog on the **Datadog Logs** destination and select **View details**.
+
+**Note**: The **Data dropped (intentional)** metric shows logs that didn't match any of the organizations' filters.
+
+### Organization-level metrics
+
+To view metrics for a specific Datadog organization:
+
+1. Navigate to [Observability Pipelines][1].
+1. Select your pipeline.
+1. Click the **Datadog Logs** destination so the organizations show up.
+  {{< img src="observability_pipelines/destinations/multi_dd_orgs_highlighted.png" alt="The Datadog Logs destination showing us1 and us3 org highlighted" style="width:45%;" >}}
+1. Click the organization you want to see metrics for.
+1. Click **View Health Metrics**.
+
+Alternatively, you can click on **Review Configured Organizations** in the Datadog Logs destination, and click the graph icon in the **Metrics** column for the organization you are interested in.
+
 ## How the destination works
 
 ### Event batching
@@ -81,3 +145,4 @@
 
 [1]: https://app.datadoghq.com/observability-pipelines
 [2]: /observability_pipelines/destinations/#event-batching
+[3]: /observability_pipelines/search_syntax/logs/