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á.

# Usar relatórios de integridade aprimorada com a API do Elastic Beanstalk
<a name="health-enhanced-api"></a>

Como os relatórios de integridade AWS Elastic Beanstalk aprimorados têm requisitos de função e pilha de soluções, você deve atualizar os scripts e o código usados antes do lançamento dos relatórios de integridade aprimorados antes de poder usá-los. Para manter a compatibilidade com versões anteriores, os relatórios de integridade aprimorada não são habilitados por padrão quando você cria um ambiente usando a API do Elastic Beanstalk.

Você configura relatórios de saúde aprimorados definindo a função de serviço, o perfil da instância e as opções de CloudWatch configuração da Amazon para seu ambiente. Você pode fazer isso de três formas: definindo as opções de configuração na pasta `.ebextensions`, com as configurações salvas, ou configurando-as diretamente no parâmetro `create-environment` da chamada `option-settings`.

Para usar a API ou a interface de linha de AWS comando (CLI) para criar um ambiente que ofereça suporte à integridade aprimorada, você deve: SDKs
+ Criar uma função de serviço e um perfil da instância com as [permissões](concepts-roles.md) apropriadas
+ Crie um ambiente com uma nova [versão da plataforma](concepts.platforms.md)
+ Definir as [opções de configuração](command-options.md) de tipo de sistema, perfil da instância e função de serviço

Use as seguintes opções de configuração nos namespaces `aws:elasticbeanstalk:healthreporting:system`, `aws:autoscaling:launchconfiguration` e `aws:elasticbeanstalk:environment` para configurar seu ambiente para os relatórios de integridade aprimorada. 

## Opções de configuração de integridade aprimorada
<a name="health-enhanced-api-options"></a>

**SystemType**

Namespace: `aws:elasticbeanstalk:healthreporting:system`

Para habilitar os relatórios de integridade aprimorada, defina como **enhanced**.

**IamInstanceProfile**

Namespace: `aws:autoscaling:launchconfiguration`

Defina como o nome de um perfil da instância configurado para uso com o Elastic Beanstalk.

**ServiceRole**

Namespace: `aws:elasticbeanstalk:environment`

Defina como o nome de uma função de serviço configurada para uso com o Elastic Beanstalk.

**ConfigDocument** (opcional)

Namespace: `aws:elasticbeanstalk:healthreporting:system`

Um documento JSON que define as métricas de instância e ambiente nas quais publicar CloudWatch. Por exemplo:

```
{
  "CloudWatchMetrics":
    {
    "Environment":
      {
      "ApplicationLatencyP99.9":60,
      "InstancesSevere":60
      }
    "Instance":
      {
      "ApplicationLatencyP85":60,
      "CPUUser": 60
      }
    }
  "Version":1
}
```

**nota**  
Os documentos de configuração podem exigir formatação especial, como aspas de escape, dependendo de como você os disponibiliza no Elastic Beanstalk. Consulte [Fornecer documentos Config de métrica personalizada](health-enhanced-cloudwatch.md#health-enhanced-cloudwatch-configdocument) para ver exemplos.