

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

# Monitoramento do objetivo
<a name="targettracking"></a>

Com o rastreamento de destinos, você pode ajustar o provisionamento de endpoints para atender às suas necessidades de capacidade com base no uso. O número de unidades de inferência se ajusta automaticamente para que a capacidade utilizada esteja dentro de uma porcentagem alvo da capacidade provisionada. Você pode usar o rastreamento de destinos para acomodar picos temporários de uso de seus endpoints de classificação de documentos e endpoints de reconhecimento de entidades. Para obter mais informações, consulte [Políticas de dimensionamento com monitoramento do objetivo para o Application Auto Scaling](https://docs.aws.amazon.com/autoscaling/application/userguide/application-auto-scaling-target-tracking.html).

**nota**  
Os exemplos a seguir estão formatados para Unix, Linux e macOS. Para Windows, substitua o caractere de continuação Unix de barra invertida (\$1) no final de cada linha por um circunflexo (^).

## Configurar o rastreamento de destinos
<a name="setup-target-tracking"></a>

Para configurar o rastreamento de destinos para um endpoint, você usa comandos da AWS CLI para registrar um destino escalável e, em seguida, criar uma política de escalabilidade. O destino escalável define as unidades de inferência como o recurso usado para ajustar o provisionamento de endpoints e a política de escalabilidade define as métricas que controlam o ajuste de escala automático da capacidade provisionada. 

**Para configurar o rastreamento de destinos**

1. Registrar um destino escalável. Os exemplos a seguir registram um destino escalável para ajustar o provisionamento de endpoints com uma capacidade mínima de 1 unidade de inferência e uma capacidade máxima de 2 unidades de inferência.

   Para um endpoint de classificação de documentos, use o seguinte comando da AWS CLI:

   ```
   aws application-autoscaling register-scalable-target \
       --service-namespace comprehend \
       --resource-id arn:aws:comprehend:region:account-id:document-classifier-endpoint/name \
       --scalable-dimension comprehend:document-classifier-endpoint:DesiredInferenceUnits \
       --min-capacity 1 \
       --max-capacity 2
   ```

   Para um endpoint reconhecedor de entidades, use o seguinte comando da CLI: AWS 

   ```
   aws application-autoscaling register-scalable-target \
       --service-namespace comprehend \
       --resource-id arn:aws:comprehend:region:account-id:entity-recognizer-endpoint/name \
       --scalable-dimension comprehend:entity-recognizer-endpoint:DesiredInferenceUnits \
       --min-capacity 1 \
       --max-capacity 2
   ```

1. Para verificar o registro do alvo escalável, use o seguinte comando da AWS CLI:

   ```
   aws application-autoscaling describe-scalable-targets \
       --service-namespace comprehend \
       --resource-id endpoint ARN
   ```

1. Crie uma configuração de rastreamento de destino para a política de escalabilidade e salve a configuração em um arquivo chamado `config.json`. Veja a seguir um exemplo de uma configuração de rastreamento de metas para um endpoint de classificação de documentos que visa manter a InferenceUtilization métrica em 70%.

   ```
   {
     "TargetValue": 70,
     "CustomizedMetricSpecification": {
       "MetricName": "InferenceUtilization",
       "Namespace": "MyNamespace",
       "Dimensions": [
         {
           "Name": "EndpointArn",
           "Value": "arn:aws:comprehend:region:account-id:document-classifier-endpoint/name"
         }
       ],
       "Statistic": "Sum",
       "Unit": "Percent"
     }
   }
   ```

   Veja a seguir um exemplo de um endpoint reconhecedor de entidades:

   ```
   {
     "TargetValue": 70,
     "CustomizedMetricSpecification": {
       "MetricName": "InferenceUtilization",
       "Namespace": "MyNamespace",
       "Dimensions": [
         {
           "Name": "EndpointArn",
           "Value": "arn:aws:comprehend:region:account-id:entity-recognizer-endpoint/name"
         }
       ],
       "Statistic": "Sum",
       "Unit": "Percent"
     }
   }
   ```

1. Criar uma política de escalabilidade. Os exemplos a seguir criam uma política de escalabilidade com base na configuração de rastreamento de destino definida no arquivo `config.json`. 

   Para um endpoint de classificação de documentos, use o seguinte comando da AWS CLI:

   ```
   aws application-autoscaling put-scaling-policy \
       --service-namespace comprehend \
       --resource-id arn:aws:comprehend:region:account-id:document-classifier-endpoint/name \
       --scalable-dimension comprehend:document-classifier-endpoint:DesiredInferenceUnits \
       --policy-name TestPolicy \
       --policy-type TargetTrackingScaling \
       --target-tracking-scaling-policy-configuration file://config.json
   ```

   Para um endpoint reconhecedor de entidades, use o seguinte comando da CLI: AWS 

   ```
   aws application-autoscaling put-scaling-policy \
       --service-namespace comprehend \
       --resource-id arn:aws:comprehend:region:account-id:entity-recognizer-endpoint/name \
       --scalable-dimension comprehend:entity-recognizer-endpoint:DesiredInferenceUnits \
       --policy-name TestPolicy \
       --policy-type TargetTrackingScaling \
       --target-tracking-scaling-policy-configuration file://config.json
   ```

## Considerações
<a name="considerations"></a>

As seguintes considerações se aplicam ao usar o rastreamento de alvos com endpoints Comprehend:
+ As métricas de endpoint são emitidas somente para solicitações bem-sucedidas. As métricas não aparecerão para solicitações que são limitadas ou falham devido a um erro interno do servidor ou do cliente.
+ Quando faltam pontos de dados, os estados do CloudWatch alarme de apoio mudarão para`INSUFFICIENT_DATA `. Quando isso acontece, o Application Auto Scaling não pode escalar seu endpoint.
+ A matemática métrica pode ser útil para contornar essa limitação. Por exemplo, para usar um valor de 0 quando nenhuma métrica for relatada, use a `FILL(m1,0)` função where `m1` is the metric. É importante testar sua configuração para garantir que ela esteja se comportando conforme o esperado. Consulte [Criação de políticas de rastreamento de metas usando matemática métrica](https://docs.aws.amazon.com/autoscaling/application/userguide/application-auto-scaling-target-tracking-metric-math.html) para obter mais opções.

## Removendo o rastreamento de destinos
<a name="remove-target-tracking"></a>

Para remover o rastreamento de destino de um endpoint, você usa comandos da AWS CLI para excluir a política de escalabilidade e, em seguida, cancelar o registro do destino escalável.

**Para remover o rastreamento de destino**

1. Exclua a política de escalabilidade Os exemplos a seguir excluem a política de escalabilidade especificada.

   Para um endpoint de classificação de documentos, use o seguinte comando da AWS CLI:

   ```
   aws application-autoscaling delete-scaling-policy \
       --service-namespace comprehend \
       --resource-id arn:aws:comprehend:region:account-id:document-classifier-endpoint/name \
       --scalable-dimension comprehend:document-classifier-endpoint:DesiredInferenceUnits \
       --policy-name TestPolicy \
   ```

   Para um endpoint reconhecedor de entidades, use o seguinte comando da CLI: AWS 

   ```
   aws application-autoscaling delete-scaling-policy \
       --service-namespace comprehend \
       --resource-id arn:aws:comprehend:region:account-id:entity-recognizer-endpoint/name \
       --scalable-dimension comprehend:entity-recognizer-endpoint:DesiredInferenceUnits \
       --policy-name TestPolicy
   ```

1. Cancelar o registro de capacidade pretendida escalável. Os exemplos a seguir cancelam o registro de um destino escalável especificado.

   Para um endpoint de classificação de documentos, use o seguinte comando da AWS CLI:

   ```
   aws application-autoscaling deregister-scalable-target \
       --service-namespace comprehend \
       --resource-id arn:aws:comprehend:region:account-id:document-classifier-endpoint/name \
       --scalable-dimension comprehend:document-classifier-endpoint:DesiredInferenceUnits
   ```

   Para um endpoint reconhecedor de entidades, use o seguinte comando da CLI: AWS 

   ```
   aws application-autoscaling deregister-scalable-target \
       --service-namespace comprehend \
       --resource-id arn:aws:comprehend:region:account-id:entity-recognizer-endpoint/name \
       --scalable-dimension comprehend:entity-recognizer-endpoint:DesiredInferenceUnits
   ```