

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Conectando Dynatrace
<a name="connecting-telemetry-sources-connecting-dynatrace"></a>

## Built-in, integración bidireccional
<a name="built-in-2-way-integration"></a>

Actualmente, AWS DevOps Agent apoya a los usuarios de Dynatrace con una integración bidireccional integrada que permite lo siguiente:
+ **Mapeo de recursos topológicos**: AWS DevOps Agent ampliará la topología del espacio de DevOps agentes con las entidades y relaciones disponibles en su entorno de Dynatrace.
+ **Activación automática de investigaciones: los** flujos de trabajo de Dynatrace se pueden configurar para iniciar investigaciones de resolución de incidentes a partir de problemas de Dynatrace.
+ Introspección **telemétrica: el AWS DevOps agente puede realizar una introspección de la** telemetría de Dynatrace mientras investiga un problema a través del servidor MCP de Dynatrace. AWS DevOps Agent-hosted 
+ **Actualizaciones de estado**: el AWS DevOps agente publicará en la interfaz de usuario de Dynatrace los principales resultados de la investigación, los análisis de las causas fundamentales y los planes de mitigación generados.

## Requisitos previos
<a name="prerequisites"></a>

La integración del AWS DevOps agente con Dynatrace requiere el SaaS de **Dynatrace**. La integración depende de las funciones de la plataforma Dynatrace (flujos de trabajo, AppEngine aplicaciones, incluida la aplicación SRE Agents y clientes OAuth) que solo están disponibles en los entornos SaaS de Dynatrace.

**Dynatrace Managed (local) no es compatible y Dynatrace no tiene previsto incorporar estas funciones** de la plataforma a Managed. Si ejecuta Dynatrace Managed, necesitará actualizar a Dynatrace SaaS antes de conectarlo al agente. AWS DevOps Consulte [Actualización de Dynatrace Managed a SaaS](https://www.dynatrace.com/platform/saas-upgrade/).

## Incorporación
<a name="onboarding"></a>

### Proceso de incorporación
<a name="onboarding-process"></a>

La incorporación de su sistema de observabilidad de Dynatrace consta de tres etapas:

1. **Connect**: establezca una conexión con Dynatrace configurando las credenciales de acceso a la cuenta, con todos los entornos que pueda necesitar

1. **Habilitar**: active Dynatrace en espacios de agentes específicos con entornos de Dynatrace específicos

1. **Configure su entorno de Dynatrace**: utilice la aplicación Dynatrace SRE Agents para completar la conexión en 2 clics

### Paso 1: Conectar
<a name="step-1-connect"></a>

Establezca una conexión con su entorno de Dynatrace

#### Configuración
<a name="configuration"></a>

1. Vaya a la página de **proveedores de capacidades** (a la que se puede acceder desde la barra de navegación lateral)

1. **Busque **Dynatrace** en la sección de proveedores **disponibles**, en **Telemetría**, y seleccione Registrarse**

1. **Cree un cliente OAuth en Dynatrace, con los permisos detallados.**

   1. [Consulte la](https://docs.dynatrace.com/docs/manage/identity-access-management/access-tokens-and-oauth-clients/oauth-clients#create-an-oauth2-client) documentación de Dynatrace

   1. Cuando esté listo, presione Siguiente

   1. Puedes conectar varios entornos de Dynatrace y, posteriormente, conectarlos a otros específicos para cada espacio de DevOps agente del que dispongas.

1. Introduce los detalles de Dynatrace desde la configuración del cliente OAuth:
   + **Nombre del cliente**
   + **ID de cliente**
   + **Secreto de cliente**
   + **URN de la cuenta**

1. Elija Siguiente.

1. Revisa y agrega

### Paso 2: Habilitar
<a name="step-2-enable"></a>

Active Dynatrace en un espacio de agente específico y configure el alcance adecuado

#### Configuración
<a name="configuration"></a>

1. En la página de espacios de agentes, seleccione un espacio de agentes y pulse ver detalles

1. Seleccione la pestaña Capacidades

1. Localice la sección de telemetría y pulse Añadir

1. Verás que Dynatrace tiene el estado «Registrado». Elija añadir para añadirlo a su espacio de agente

1. ID de entorno de Dynatrace: proporcione el ID de entorno de Dynatrace que le gustaría asociar a este espacio de agentes. DevOps 

1. Introduzca uno o más identificadores de entidad de Dynatrace; estos ayudan al DevOps agente a descubrir sus recursos más importantes; por ejemplo, servicios o aplicaciones. **Si no está seguro, puede presionar quitar.**

1. Revise y pulse Guardar

1. Copia la URL del Webhook y el secreto del Webhook. Los usará en la aplicación Dynatrace **SRE Agents** para completar la conexión. Consulte la [sección Cómo empezar](https://www.dynatrace.com/hub/detail/community-cloudsreagents/) para obtener más información.

### Paso 3: Configure su entorno de Dynatrace
<a name="step-3-configure-your-dynatrace-environment"></a>

Para completar la configuración de Dynatrace, utilice la aplicación Dynatrace **SRE Agents** para configurar la parte de Dynatrace de la integración con 2 clics; no es necesario configurar el flujo de trabajo manual. [Para obtener más información, consulte la sección Primeros pasos.](https://www.dynatrace.com/hub/detail/community-cloudsreagents/)

#### Esquemas de eventos compatibles
<a name="supported-event-schemas"></a>

AWS DevOps El agente admite dos tipos de eventos de Dynatrace mediante webhooks. Los esquemas de eventos compatibles se documentan a continuación:

##### Incidente o evento
<a name="incident-event"></a>

Los incidentes se utilizan para iniciar una investigación. El esquema de eventos es:

```
{
    "event.id": string;
    "event.status": "ACTIVE" | "CLOSED";
    "event.status_transition": string;
    "event.description": string;
    "event.name": string;
    "event.category": "AVAILABILITY" | "ERROR" | "SLOWDOWN" | "RESOURCE_CONTENTION" | "CUSTOM_ALERT" | "MONITORING_UNAVAILABLE" | "INFO";
    "event.start"?: string;
    "affected_entity_ids"?: string[];
}
```

##### Evento de mitigación
<a name="mitigation-event"></a>

Los eventos de mitigación se utilizan para activar la generación de un informe de mitigación para la investigación sobre los próximos pasos. El esquema del evento es:

```
{
    "task_id": string;
    "task_version": number;
    "event.type": "mitigation_request";
}
```

## Eliminación
<a name="removal"></a>

La fuente de telemetría está conectada en dos niveles: a nivel de espacio de agente y a nivel de cuenta. Para eliminarla por completo, primero debe eliminarla de todos los espacios de agentes en los que se utilice y, a continuación, podrá anular su registro.

### Paso 1: Eliminar del espacio de agentes
<a name="step-1-remove-from-agent-space"></a>

1. En la página de espacios de agentes, selecciona un espacio de agentes y pulsa ver detalles

1. Seleccione la pestaña Capacidades

1. Desplázate hacia abajo hasta la sección de telemetría

1. Selecciona Dynatrace

1. Presiona quitar

### Paso 2: Anular el registro de la cuenta
<a name="step-2-deregister-from-account"></a>

1. Vaya a la página de **proveedores de capacidades** (a la que se puede acceder desde la barra de navegación lateral)

1. Desplázate hasta la sección **Registrados actualmente**.

1. Comprueba que el número de espacios para agentes sea cero (si no, repite el paso 1 anterior en los demás espacios para agentes)

1. Presiona Cancelar registro junto a Dynatrace