

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>

## Integração bidirecional integrada
<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 Dynatrace MCP hospedado pelo agente. AWS DevOps 
+ **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.

## 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** - baixe os fluxos de trabalho e o painel e importe para o Dynatrace, anotando os detalhes do webhook para acionar investigações nos espaços designados do agente

### 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 clique em Registrar****

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

   1. Veja a documentação do [Dynatrace](https://docs.dynatrace.com/docs/shortlink/aws-devops-agent)

   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 OAuth cliente:
   + **Nome do cliente**
   + **ID do cliente**
   + **Segredo do cliente**
   + **URN da conta**

1. Clique em Avançar.

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”. Clique em adicionar para adicioná-lo 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 entidades da Dynatrace IDs - 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. Consulte a [documentação do Dynatrace](https://docs.dynatrace.com/docs/shortlink/aws-devops-agent) para adicionar essas credenciais ao Dynatrace.

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

Para concluir a configuração do Dynatrace, você precisará executar determinadas etapas de configuração em seu ambiente Dynatrace. Siga as instruções na documentação do [Dynatrace](https://docs.dynatrace.com/docs/shortlink/aws-devops-agent).

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