Visibilidad entre organizaciones

La visibilidad entre organizaciones está en fase beta privada para los clientes con planes Enterprise. Si estás interesado en tener esta función, ponte en contacto con tu gestor técnico de cuentas o gestor de éxito del cliente.

Información general

Algunas empresas recurren a varias organizaciones de Datadog para aislar los datos por motivos de conformidad u otros.

La visibilidad entre organizaciones permite a los clientes compartir datos entre diferentes organizaciones en la misma cuenta y mostrar información de varias organizaciones en un solo lugar.

En este documento, se explica lo siguiente:

  • Qué [permite] la visibilidad entre organizaciones (#capabilities)
  • Cómo exponer datos entre organizaciones
  • Cómo crear un widget de dashboard y notebook con datos de otras organizaciones

Funcionalidades

Conexión de la organización

Una organización de origen expone datos a una organización de destino a través de una conexión de organización. Las organizaciones de Datadog de origen y de destino deben estar en la misma cuenta. Una organización de origen puede tener varios destinos, y una organización de destino puede tener varios orígenes.

Después de configurar una conexión de organización, los datos expuestos siguen viviendo en la organización de origen y no se mueven al destino. En su lugar, la organización de destino consulta los datos desde el origen. Las conexiones no duplican los datos y no incurren en gastos adicionales. La organización de destino puede consultar los datos de origen desde cualquier intervalo de tiempo admitido por los datos de origen, incluso antes de la fecha de creación de la conexión. Si eliminas la conexión, el destino ya no podrá acceder a ningún dato del origen.

Contexto

La visibilidad entre organizaciones admite la telemetría de métricas en [widgets de dashboard y notebook] privados2.

Se admiten todos los tipos de métricas, incluidas métricas personalizadas, métricas de trazas y métricas generadas a partir de logs.

Configurar conexiones

Lista de conexiones

Para examinar las conexiones, ve a la página de visibilidad entre organizaciones en Parámetros de organización. La tabla enumera todas tus conexiones entre organizaciones.

Crear una conexión

La creación de una conexión entre organizaciones permite consultar métricas desde la organización de origen en la organización de destino.

  1. Asegúrate de haber iniciado sesión en la organización de origen que contiene los datos que deseas exponer.
  2. En la página de visibilidad entre organizaciones, haz clic en New Connection (Nueva conexión). Aparece el cuadro de diálogo New Connection (Nueva conexión).
  3. En el menú desplegable, selecciona la organización de destino en la que deseas ver los datos.
  4. Haz clic en Connect (Conectar).

Eliminar una conexión

Al eliminar una conexión, se desactiva la consulta entre organizaciones desde la organización de destino de las métricas de la organización de origen.

  1. Navega hasta la página de visibilidad entre organizaciones en Parámetros de organización.
  2. Sitúa el cursor sobre la conexión que deseas eliminar. Aparecerá un icono de papelera (Eliminar) a la derecha.
  3. Haz clic en el icono de la papelera (Eliminar) sobre la conexión que deseas suprimir. Aparecerá el mensaje Are you sure? (¿Estás seguro?).
  4. Haz clic en Eliminar.

En la API

Para Configurar conexiones mediante la API, consulta la API de conexiones entre organizaciones.

Crear una widget con datos entre organizaciones

Los widgets de dashboard y notebook entre organizaciones están disponibles para las organizaciones de Datadog que existen como organización de destino para al menos una conexión.

Cada consulta en un widget puede mostrar datos de una sola organización. Puedes combinar consultas en una fórmula de consulta entre organizaciones.

En la interfaz de usuario

Los widgets de dashboard y notebook te permiten crear consultas entre organizaciones cuando se cumplen las siguientes condiciones:

  • Tienes habilitada la visibilidad entre organizaciones en tu organización
  • Existe al menos una conexión en la que la organización actual es el destino

Si se cumplen las condiciones anteriores, aparecerá un selector desplegable de organización entre los menús desplegables de tipo de datos y nombre de métrica. Utiliza el selector desplegable de organización para elegir una organización de origen para tu consulta.

En la siguiente captura de pantalla, se muestra un ejemplo de consulta de fórmula entre organizaciones. El widget representa gráficamente el número de eventos incorporados por servicio. Para obtener el número total de eventos, la fórmula de consulta entre organizaciones suma los datos de la organización A (en la consulta a) y la organización B (en la consulta b).

Captura de pantalla que muestra la configuración de un widget de dashboard con una consulta entre organizaciones

En la API

El proveedor de Datadog Terraform no admite consultas entre organizaciones.

Puedes definir consultas entre organizaciones en el siguiente endpoint:

Cuando definas un widget en la API de dashboard, utiliza el parámetro cross_org_uuids en la carga de definición del widget de JSON, con el fin de identificar la organización de origen en una consulta entre organizaciones.

El parámetro cross_org_uuids es opcional. Si omites cross_org_uuids, la consulta se ejecuta en la misma organización en la que definiste el widget.

Ejemplo de definición de widget de JSON

{
    "viz": "timeseries",
    "requests": [
        {
            "style": {
                "palette": "dog_classic",
                "type": "solid",
                "width": "normal"
            },
            "type": "line",
            "formulas": [
                {
                    "formula": "query2 + query1"
                }
            ],
            "queries": [
                {
                    "name": "query2",
                    "data_source": "metrics",
                    "query": "sum:datadog.estimated_usage.events.ingested_events{env:prod} by {service}.as_count()",
                    "cross_org_uuids": ["6434abde-xxxx-yyyy-zzzz-da7ad0900001"]
                },
                {
                    "name": "query1",
                    "data_source": "metrics",
                    "query": "sum:datadog.estimated_usage.events.ingested_events{env:prod} by {service}.as_count()",
                    "cross_org_uuids": ["74edde28-xxxx-yyyy-zzzz-da7ad0900001"]
                }
            ],
            "response_format": "timeseries"
        }
    ]
}

Observa el parámetro cross_org_uuids en la carga de la definición del widget de JSON.

  • Este parámetro es opcional. Si se omite, la consulta se ejecuta en la organización en la que se ha definido el widget.
  • Utiliza el identificador de organización, que puedes recuperar del endpoint Organizaciones, para identificar la organización en la que se ejecuta la consulta.
  • Aunque este parámetro acepta una matriz, ésta debe contener un solo elemento. Si se añaden varios elementos a la matriz cross_org_uuids, se produce un error 400.