From 86190aaa4a6601e86ba067ad4325e9fea7923511 Mon Sep 17 00:00:00 2001
From: Gabe Schenz <gabe@sche.nz>
Date: Mon, 17 Jun 2024 17:51:00 -0500
Subject: [PATCH] doc: add datadog connection json structure. (#40198)

---
 .../connections/datadog.rst                   | 22 +++++++++++++++++++
 1 file changed, 22 insertions(+)

diff --git a/docs/apache-airflow-providers-datadog/connections/datadog.rst b/docs/apache-airflow-providers-datadog/connections/datadog.rst
index dccc1caf68f03..b56ad1f82b7c1 100644
--- a/docs/apache-airflow-providers-datadog/connections/datadog.rst
+++ b/docs/apache-airflow-providers-datadog/connections/datadog.rst
@@ -44,3 +44,25 @@ Extra
     ``app_key``: Datadog `application key <https://docs.datadoghq.com/account_management/api-app-keys/#application-keys>`__
 
     ``source_type_name``: Datadog `source type name <https://docs.datadoghq.com/integrations/faq/list-of-api-source-attribute-value/>`__ (defaults to my_apps).
+
+
+Secret Management
+-----------------
+
+When storing the connection details in a secret management system, it can be convenient to name the secret with the default value::
+
+  secret name: airflow/connections/datadog_default
+
+The following json is an example of what the secret contents should look like::
+
+  {
+    "conn_type": "datadog",
+    "description": "Datadog connection for my app",
+    "extra": {
+      "api_host": "https://api.datadoghq.com",
+      "api_key": "my api key",
+      "app_key": "my app key",
+      "source_type_name": "apache"
+    },
+    "host": "environment-region-application.domain.com"
+  }