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

# CloudWatch métricas para AWS PrivateLink
<a name="privatelink-cloudwatch-metrics"></a>

AWS PrivateLink publica pontos de dados na Amazon CloudWatch para seus endpoints de interface, endpoints do Gateway Load Balancer e serviços de endpoint. CloudWatch permite que você recupere estatísticas sobre esses pontos de dados como um conjunto ordenado de dados de séries temporais, conhecido como *métricas*. Considere uma métrica como uma variável a ser monitorada, e os pontos de dados como os valores dessa variável ao longo do tempo. Cada ponto de dados tem um time stamp associado e uma unidade de medida opcional.

É possível usar métricas para verificar se o sistema está executando conforme o esperado. Por exemplo, você pode criar um CloudWatch alarme para monitorar uma métrica específica e iniciar uma ação (como enviar uma notificação para um endereço de e-mail) se a métrica estiver fora do que você considera um intervalo aceitável.

Métricas são publicadas para todos os endpoints de interface, endpoints de balanceador de carga de gateway e serviços de endpoint. Elas não são publicadas para endpoints de gateway nem para consumidores de serviço de endpoint que usam acesso inter-regional. Por padrão, AWS PrivateLink envia métricas para CloudWatch em intervalos de um minuto, sem custo adicional. 

Para obter mais informações, consulte o [Guia CloudWatch do usuário da Amazon](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/).

**Topics**
+ [

## Métricas e dimensões de endpoints
](#endpoint-metrics-dimensions)
+ [

## Métricas e dimensões de serviços de endpoint
](#endpoint-service-metrics-dimensions)
+ [

## Veja as CloudWatch métricas
](#view-privatelink-metrics)
+ [

## Usar regras integradas do Contributor Insights
](#privatelink-contributor-insights)

## Métricas e dimensões de endpoints
<a name="endpoint-metrics-dimensions"></a>

O namespace `AWS/PrivateLinkEndpoints` inclui as seguintes métricas para endpoints de interface e endpoints de balanceador de carga de gateway.


| Métrica | Description | 
| --- | --- | 
| ActiveConnections |  O número de conexões ativas simultâneas. Isso métrica inclui conexões nos estados SYN\$1SENT e ESTABLISHED. **Reporting criteria** (Critérios de relatório): o endpoint recebeu tráfego durante o período de um minuto. **Estatísticas**: as estatísticas mais úteis são `Average`, `Maximum` e `Minimum`. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/vpc/latest/privatelink/privatelink-cloudwatch-metrics.html)  | 
| BytesProcessed |  O número de bytes que foram trocados entre os endpoints e os serviços de endpoint, agregados em ambas as direções. Este é o número de bytes cobrados do proprietário do endpoint. A fatura discrimina esse valor em GB. **Reporting criteria** (Critérios de relatório): o endpoint recebeu tráfego durante o período de um minuto. **Statistics** (Estatísticas): as estatísticas mais úteis são `Average`, `Sum`, `Maximum` e `Minimum`. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/vpc/latest/privatelink/privatelink-cloudwatch-metrics.html)  | 
| NewConnections |  O número de novas conexões estabelecidas por meio do endpoint. **Reporting criteria** (Critérios de relatório): o endpoint recebeu tráfego durante o período de um minuto. **Statistics** (Estatísticas): as estatísticas mais úteis são `Average`, `Sum`, `Maximum` e `Minimum`. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/vpc/latest/privatelink/privatelink-cloudwatch-metrics.html)  | 
| PacketsDropped |  O número de pacotes descartados pelo endpoint. Essa métrica pode não capturar todos os descartes de pacotes. Um aumento nos valores pode indicar que o serviço de endpoint ou o endpoint não está íntegro. **Reporting criteria** (Critérios de relatório): o endpoint recebeu tráfego durante o período de um minuto. **Estatísticas**: as estatísticas mais úteis são `Average`, `Sum` e `Maximum`. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/vpc/latest/privatelink/privatelink-cloudwatch-metrics.html)  | 
| RstPacketsReceived |  O número de pacotes RST recebidos pelo endpoint. Um aumento nos valores pode indicar que o serviço de endpoint não está íntegro. **Reporting criteria** (Critérios de relatório): o endpoint recebeu tráfego durante o período de um minuto. **Estatísticas**: as estatísticas mais úteis são `Average`, `Sum` e `Maximum`. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/vpc/latest/privatelink/privatelink-cloudwatch-metrics.html)  | 

Para filtrar essas métricas, use as seguintes dimensões.


| Dimensão | Description | 
| --- | --- | 
| Endpoint Type | Filtra os dados das métricas por tipo de endpoint (Interface \$1 GatewayLoadBalancer). | 
| Service Name | Filtra os dados das métricas por nome do serviço. | 
| Subnet Id | Filtra os dados das métricas por sub-rede. | 
| VPC Endpoint Id | Filtra os dados das métricas por endpoint da VPC. | 
| VPC Id | Filtra os dados das métricas por VPC. | 

## Métricas e dimensões de serviços de endpoint
<a name="endpoint-service-metrics-dimensions"></a>

O namespace `AWS/PrivateLinkServices` inclui as seguintes métricas para serviços de endpoint.


| Métrica | Description | 
| --- | --- | 
| ActiveConnections |  O número máximo de conexões ativas provenientes de clientes com destinos através dos endpoints. Um aumento nos valores pode indicar a necessidade de adicionar destinos ao balanceador de carga. **Reporting criteria** (Critérios de relatório): um endpoint que está conectado ao serviço de endpoint enviou tráfego durante o período de um minuto. **Estatísticas**: as estatísticas mais úteis são `Average` e `Maximum`. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/vpc/latest/privatelink/privatelink-cloudwatch-metrics.html)  | 
| BytesProcessed |  O número de bytes que foram trocados os serviços de endpoints e endpoints, em ambas as direções. **Reporting criteria** (Critérios de relatório): um endpoint que está conectado ao serviço de endpoint enviou tráfego durante o período de um minuto. **Estatísticas**: as estatísticas mais úteis são `Average`, `Sum` e `Maximum`. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/vpc/latest/privatelink/privatelink-cloudwatch-metrics.html)  | 
| EndpointsCount |  O número de endpoints que estão conectados ao serviço de endpoint. **Reporting criteria** (Critérios de relatório): existe um valor diferente de zero durante o período de cinco minutos. **Estatísticas**: as estatísticas mais úteis são `Average` e `Maximum`. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/vpc/latest/privatelink/privatelink-cloudwatch-metrics.html)  | 
| NewConnections |  O número máximo de novas conexões estabelecidas de clientes com destinos através dos endpoints. Um aumento nos valores pode indicar a necessidade de adicionar destinos ao balanceador de carga. **Reporting criteria** (Critérios de relatório): um endpoint que está conectado ao serviço de endpoint enviou tráfego durante o período de um minuto. **Estatísticas**: as estatísticas mais úteis são `Average`, `Sum` e `Maximum`. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/vpc/latest/privatelink/privatelink-cloudwatch-metrics.html)  | 
| RstPacketsSent |  O número de pacotes RST que foram enviados a endpoints pelo serviço de endpoint. Um aumento nos valores pode indicar que existem destinos não íntegros. **Reporting criteria** (Critérios de relatório): um endpoint que está conectado ao serviço de endpoint enviou tráfego durante o período de um minuto. **Estatísticas**: as estatísticas mais úteis são `Average`, `Sum` e `Maximum`. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/vpc/latest/privatelink/privatelink-cloudwatch-metrics.html)  | 

Para filtrar essas métricas, use as seguintes dimensões.


| Dimensão | Description | 
| --- | --- | 
| Az | Filtra os dados de métrica por zona de disponibilidade. | 
| Load Balancer Arn | Filtra os dados da métrica por load balancer. | 
| Service Id | Filtra os dados das métricas por serviço de endpoint. | 
| VPC Endpoint Id | Filtra os dados das métricas por endpoint da VPC. | 

## Veja as CloudWatch métricas
<a name="view-privatelink-metrics"></a>

Você pode visualizar essas CloudWatch métricas usando o console da Amazon VPC, o CloudWatch console ou o AWS CLI seguinte.

**Para visualizar métricas usando o console da Amazon VPC**

1. Abra o console da Amazon VPC em [https://console.aws.amazon.com/vpc/](https://console.aws.amazon.com/vpc/).

1. No painel de navegação, escolha **Endpoints**. Selecione o endpoint e escolha a guia **Monitoring** (Monitoramento).

1. No painel de navegação, escolha **Endpoint Services** (Serviços do endpoint). Selecione o serviço de endpoint e escolha a guia **Monitoring** (Monitoramento).

**Para visualizar métricas usando o CloudWatch console**

1. Abra o CloudWatch console em [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/).

1. No painel de navegação, selecione **Métricas**.

1. Selecione o **namespace AWS/ PrivateLinkEndpoints**.

1. Selecione o **namespace AWS/ PrivateLinkServices**.

**Para visualizar métricas usando o AWS CLI**  
Use o seguinte comando [list-metrics](https://docs.aws.amazon.com/cli/latest/reference/cloudwatch/list-metrics.html) para listar as métricas disponíveis para endpoints de interface e endpoints de balanceador de rede de gateway:

```
aws cloudwatch list-metrics --namespace AWS/PrivateLinkEndpoints
```

Use o comando [list-metrics](https://docs.aws.amazon.com/cli/latest/reference/cloudwatch/list-metrics.html) para listar as métricas disponíveis para serviços de endpoint:

```
aws cloudwatch list-metrics --namespace AWS/PrivateLinkServices
```

## Usar regras integradas do Contributor Insights
<a name="privatelink-contributor-insights"></a>

AWS PrivateLink fornece regras integradas do Contributor Insights para seus serviços de endpoint para ajudá-lo a descobrir quais endpoints são os maiores contribuintes para cada métrica suportada. Para obter mais informações, consulte [Contributor Insights](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/ContributorInsights.html) no *Guia do CloudWatch usuário da Amazon*.

AWS PrivateLink fornece as seguintes regras:
+ `VpcEndpointService-ActiveConnectionsByEndpointId-v1` – Classifica endpoints pelo número de conexões ativas.
+ `VpcEndpointService-BytesByEndpointId-v1` – Classifica endpoints pelo número de bytes processados.
+ `VpcEndpointService-NewConnectionsByEndpointId-v1` – Classifica endpoints pelo número de novas conexões.
+ `VpcEndpointService-RstPacketsByEndpointId-v1` –Classifica endpoints pelo número de pacotes RST que foram enviados a endpoints.

Para usar uma regra integrada, é necessário habilitá-la. Depois que você habilita uma regra, ela começa a coletar dados do colaborador. Para obter informações sobre as cobranças do Contributor Insights, consulte [Amazon CloudWatch Pricing](https://aws.amazon.com/cloudwatch/pricing/).

É necessário ter as seguintes permissões para usar o Contributor Insights:
+ `cloudwatch:DeleteInsightRules`: para excluir as regras do Contributor Insights.
+ `cloudwatch:DisableInsightRules`: para desabilitar regras do Contributor Insights.
+ `cloudwatch:GetInsightRuleReport`: para obter os dados.
+ `cloudwatch:ListManagedInsightRules`: para listar as regras do Contributor Insights.
+ `cloudwatch:PutManagedInsightRules`: para habilitar as regras do Contributor Insights.

**Topics**
+ [

### Habilitar as regras do Contributor Insights
](#enable-contributor-insights)
+ [

### Desabilitar as regras do Contributor Insights
](#disable-contributor-insights)
+ [

### Excluir as regras do Contributor Insights
](#delete-contributor-insights)

### Habilitar as regras do Contributor Insights
<a name="enable-contributor-insights"></a>

Use os procedimentos a seguir para ativar as regras internas para AWS PrivateLink usar o Console de gerenciamento da AWS ou AWS CLI o.

**Para habilitar as regras do Contributor Insights para AWS PrivateLink usar o console**

1. Abra o console da Amazon VPC em [https://console.aws.amazon.com/vpc/](https://console.aws.amazon.com/vpc/).

1. No painel de navegação, escolha **Endpoint Services** (Serviços do endpoint).

1. Selecione o serviço de endpoint.

1. Na guia **Contributor Insights**, escolha **Enable** (Habilitar). 

1. (Opcional) Por padrão, todas as regras são habilitadas. Para habilitar somente regras específicas, selecione as regras que não devem ser habilitadas e, em seguida, escolha **Actions** (Ações), **Disable rule** (Desabilitar regra). Quando a confirmação for solicitada, escolha **Disable ** (Desabilitar).

**Para habilitar as regras do Contributor Insights para AWS PrivateLink usar o AWS CLI**

1. Use o [list-managed-insight-rules](https://docs.aws.amazon.com/cli/latest/reference/cloudwatch/list-managed-insight-rules.html)comando da seguinte forma para enumerar as regras disponíveis. Na opção `--resource-arn`, especifique o ARN do serviço de endpoint.

   ```
   aws cloudwatch list-managed-insight-rules --resource-arn arn:aws:ec2:region:account-id:vpc-endpoint-service/vpc-svc-0123456789EXAMPLE
   ```

1. Na saída do comando `list-managed-insight-rules`, copie o nome do modelo do campo `TemplateName`. A seguir, temos um exemplo desse campo.

   ```
   "TemplateName": "VpcEndpointService-NewConnectionsByEndpointId-v1"
   ```

1. Use o [put-managed-insight-rules](https://docs.aws.amazon.com/cli/latest/reference/cloudwatch/put-managed-insight-rules.html)comando da seguinte forma para ativar a regra. Você deve especificar o nome do modelo e o ARN do serviço de endpoint.

   ```
   aws cloudwatch put-managed-insight-rules --managed-rules TemplateName=VpcEndpointService-NewConnectionsByEndpointId-v1,ResourceARN=arn:aws:ec2:region:account-id:vpc-endpoint-service/vpc-svc-0123456789EXAMPLE
   ```

### Desabilitar as regras do Contributor Insights
<a name="disable-contributor-insights"></a>

Você pode desativar as regras integradas do AWS PrivateLink a qualquer momento. Depois que você desabilitar uma regra, ela interromperá a coleta de dados do colaborador, mas os dados existentes do colaborador serão mantidos até que eles completem 15 dias. Após desabilitar uma regra, você poderá habilitá-la novamente para retomar a coleta de dados.

**Para desativar as regras do Contributor Insights para AWS PrivateLink usar o console**

1. Abra o console da Amazon VPC em [https://console.aws.amazon.com/vpc/](https://console.aws.amazon.com/vpc/).

1. No painel de navegação, escolha **Endpoint Services** (Serviços do endpoint).

1. Selecione o serviço de endpoint.

1. Na guia **Contributor Insights**, escolha **Disable all** (Desabilitar todas) para desabilitar todas as regras. Como alternativa, expanda o painel **Rules** (Regras), selecione as regras a serem desabilitadas e escolha **Actions** (Ações), **Disable rule**(Desabilitar regra)

1. Quando a confirmação for solicitada, escolha **Disable ** (Desabilitar).

**Para desativar as regras do Contributor Insights para AWS PrivateLink usar o AWS CLI**  
Use o [disable-insight-rules](https://docs.aws.amazon.com/cli/latest/reference/cloudwatch/disable-insight-rules.html)comando para desativar uma regra.

### Excluir as regras do Contributor Insights
<a name="delete-contributor-insights"></a>

Use os procedimentos a seguir para excluir as regras internas para AWS PrivateLink usar o Console de gerenciamento da AWS ou AWS CLI o. Depois que você exclui uma regra, ela interrompe a coleta de dados do colaborador e excluímos os dados existentes do colaborador.

**Para excluir as regras do Contributor Insights para AWS PrivateLink usar o console**

1. Abra o CloudWatch console em [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/).

1. No painel de navegação, escolha **Insights**, **Contributor Insights**.

1. Expanda o painel **Rules** (Regras) e selecione as regras.

1. Escolha **Actions** (Ações), **Delete rule** (Excluir regra).

1. Quando a confirmação for solicitada, escolha **Excluir**.

**Para excluir as regras do Contributor Insights para AWS PrivateLink usar o AWS CLI**  
Use o [delete-insight-rules](https://docs.aws.amazon.com/cli/latest/reference/cloudwatch/delete-insight-rules.html)comando para excluir uma regra.