

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>

## Integración bidireccional integrada
<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 alojado en el agente. AWS DevOps 
+ **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.

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

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

La incorporación del 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**: descargue los flujos de trabajo y el panel de control e impórtelos a Dynatrace y anote los detalles del webhook para iniciar las investigaciones en los espacios de agentes designados

### 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 haga clic en Registrarse**

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

   1. [Consulte la documentación de Dynatrace](https://docs.dynatrace.com/docs/shortlink/aws-devops-agent)

   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. Haga clic en 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». Haga clic en 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 una o más entidades de Dynatrace. Estas entidades ayudarán a los DevOps agentes a descubrir sus recursos más importantes IDs ; por ejemplo, servicios o aplicaciones. **Si no está seguro, puede pulsar quitar.**

1. Revise y pulse Guardar

1. Copia la URL del Webhook y el secreto del Webhook. Consulte la [documentación de Dynatrace para añadir estas credenciales](https://docs.dynatrace.com/docs/shortlink/aws-devops-agent) a Dynatrace.

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

Para completar la configuración de Dynatrace, deberá realizar ciertos pasos de configuración en su entorno de Dynatrace. [Siga las instrucciones de la documentación de Dynatrace.](https://docs.dynatrace.com/docs/shortlink/aws-devops-agent)

#### 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