As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

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

## Built-in, integração bidirecional
<a name="built-in-2-way-integration"></a>

Atualmente, o AWS DevOps Agent oferece suporte aos usuários do Dynatrace com uma integração bidirecional integrada que permite o seguinte:
+ **Mapeamento de recursos de topologia** - O AWS DevOps agente aumentará sua topologia do espaço do DevOps agente com entidades e relacionamentos disponíveis em seu ambiente Dynatrace.
+ **Acionamento automatizado de investigações - Os** fluxos de trabalho do Dynatrace podem ser configurados para acionar investigações de resolução de incidentes a partir de problemas do Dynatrace.
+ Introspecção de **telemetria - O AWS DevOps agente pode fazer uma introspecção da** telemetria do Dynatrace enquanto investiga um problema por meio do servidor MCP do Dynatrace. AWS DevOps Agent-hosted 
+ **Atualizações de status** - O AWS DevOps agente publicará as principais descobertas da investigação, análises da causa raiz e planos de mitigação gerados na interface de usuário do Dynatrace.

## Pré-requisitos
<a name="prerequisites"></a>

A integração do AWS DevOps agente com o Dynatrace requer o SaaS da **Dynatrace**. A integração depende dos recursos da plataforma Dynatrace (fluxos de trabalho, AppEngine aplicativos, incluindo o aplicativo SRE Agents e clientes OAuth) que estão disponíveis somente nos ambientes SaaS da Dynatrace.

O **Dynatrace Managed (local) não é suportado**, e a Dynatrace não tem planos de trazer esses recursos da plataforma para o Managed. Se você estiver executando o Dynatrace Managed, precisará fazer o upgrade para o Dynatrace SaaS antes de conectá-lo ao Agent. AWS DevOps Consulte [Atualização do Dynatrace Managed para](https://www.dynatrace.com/platform/saas-upgrade/) SaaS.

## Onboarding
<a name="onboarding"></a>

### Processo de integração
<a name="onboarding-process"></a>

A integração do seu sistema de observabilidade Dynatrace envolve três etapas:

1. **Connect** - Estabeleça uma conexão com o Dynatrace configurando as credenciais de acesso à conta, com todos os ambientes que você possa precisar

1. **Habilitar** - Ative o Dynatrace em espaços específicos do Agente com ambientes específicos do Dynatrace

1. **Configure seu ambiente Dynatrace** - use o aplicativo Dynatrace SRE Agents para concluir a conexão em 2 cliques

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

Estabeleça conexão com seu ambiente Dynatrace

#### Configuração
<a name="configuration"></a>

1. Vá para a página **Capability Providers** (acessível na navegação lateral)

1. **Encontre o **Dynatrace** na seção Provedores **disponíveis** em **Telemetria** e escolha Registrar**

1. **Crie um cliente OAuth no Dynatrace, com as permissões detalhadas.**

   1. Veja a documentação do [Dynatrace](https://docs.dynatrace.com/docs/manage/identity-access-management/access-tokens-and-oauth-clients/oauth-clients#create-an-oauth2-client)

   1. Quando estiver pronto, pressione Avançar

   1. Você pode conectar vários ambientes do Dynatrace e, posteriormente, o escopo a ambientes específicos para cada espaço de DevOps agente que você possa ter.

1. Insira seus detalhes do Dynatrace na configuração do cliente OAuth:
   + **Nome do cliente**
   + **ID do cliente**
   + **Segredo do cliente**
   + **URN da conta**

1. Escolha Próximo.

1. Revise e adicione

### Etapa 2: ativar
<a name="step-2-enable"></a>

Ative o Dynatrace em um espaço de agente específico e configure o escopo apropriado

#### Configuração
<a name="configuration"></a>

1. Na página de espaços do agente, selecione um espaço do agente e pressione visualizar detalhes

1. Selecione a guia Capacidades

1. Localize a seção Telemetria, pressione Adicionar

1. Você notará que o Dynatrace está com o status “Registrado”. Escolha adicionar para adicionar isso ao seu espaço de agente

1. ID do ambiente Dynatrace - forneça a ID do ambiente Dynatrace que você gostaria de associar a esse espaço do agente. DevOps 

1. Insira uma ou mais IDs de entidade da Dynatrace - elas ajudam o DevOps agente a descobrir seus recursos mais importantes. Exemplos podem ser serviços ou aplicativos. **Se você não tiver certeza, pode pressionar remover.**

1. Revise e pressione Salvar

1. Copie o URL do Webhook e o Segredo do Webhook. Você os usará no aplicativo Dynatrace **SRE Agents** para concluir a conexão. Consulte a [seção Introdução](https://www.dynatrace.com/hub/detail/community-cloudsreagents/) para obter detalhes.

### Etapa 3: Configurar seu ambiente Dynatrace
<a name="step-3-configure-your-dynatrace-environment"></a>

Para concluir sua configuração do Dynatrace, use o aplicativo Dynatrace **SRE Agents** para configurar o lado Dynatrace da integração em 2 cliques — nenhuma configuração manual do fluxo de trabalho é necessária. Para obter detalhes, consulte a [seção Introdução](https://www.dynatrace.com/hub/detail/community-cloudsreagents/).

#### Esquemas de eventos compatíveis
<a name="supported-event-schemas"></a>

AWS DevOps O agente suporta dois tipos de eventos do Dynatrace usando webhooks. Os esquemas de eventos compatíveis estão documentados abaixo:

##### Evento de incidente
<a name="incident-event"></a>

Eventos incidentes são usados para acionar uma investigação. O esquema do evento é:

```
{
    "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 mitigação
<a name="mitigation-event"></a>

Os eventos de mitigação são usados para acionar a geração de um relatório de mitigação para a investigação das próximas etapas. O esquema do evento é:

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

## Remoção
<a name="removal"></a>

A fonte de telemetria é conectada em dois níveis no nível do espaço do agente e no nível da conta. Para removê-lo completamente, você deve primeiro removê-lo de todos os espaços do agente em que ele é usado e, em seguida, ele pode ser cancelado.

### Etapa 1: Remover do espaço do agente
<a name="step-1-remove-from-agent-space"></a>

1. Na página de espaços do agente, selecione um espaço do agente e pressione visualizar detalhes

1. Selecione a guia Capacidades

1. Role para baixo até a seção Telemetria

1. Selecione Dynatrace

1. Pressione remover

### Etapa 2: Cancelar o registro da conta
<a name="step-2-deregister-from-account"></a>

1. Vá para a página **Capability Providers** (acessível na navegação lateral)

1. Role até a seção **Registrado atualmente**.

1. Verifique se a contagem de espaço do agente é zero (se não, repita a Etapa 1 acima nos outros espaços do agente)

1. Pressione Cancelar registro ao lado de Dynatrace