Métricas do grupo de usuários em CloudWatch - Amazon Cognito

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

Métricas do grupo de usuários em CloudWatch

Os grupos de usuários relatam as estatísticas da atividade do usuário CloudWatch como métricas. A partir de CloudWatch, você pode analisar o volume da atividade de autenticação e o uso da cota em seus grupos de usuários. Com as informações nessas métricas, você pode definir alarmes para eventos dignos de nota e ajustar a configuração do grupo de usuários conforme necessário. Onde o registro de atividades do usuário tem registros detalhados da atividade do usuário em seus grupos de usuários, CloudWatch as métricas têm estatísticas agregadas e indicadores de desempenho.

A tabela a seguir lista as métricas disponíveis para grupos de usuários do Amazon Cognito. O namespace de métricas Amazon CloudWatch para o Amazon Cognito é AWS/Cognito. Para obter mais informações, consulte Namespaces no Guia CloudWatch do usuário da Amazon.

nota

As métricas que não tiverem tido novos pontos de dados nas últimas duas semanas não serão exibidas no console. Elas também não são exibidas quando você insere o nome da métrica ou os nomes de dimensão na caixa de pesquisa na guia All metrics (Todas as métricas) no console. Além disso, elas não são retornados nos resultados de um comando list-metrics. A melhor maneira de recuperar essas métricas é com os get-metric-statistics comandos get-metric-data ou no AWS CLI.

Métrica Descrição
SignUpSuccesses

Fornece o número total de solicitações bem-sucedidas de registro de usuário feitas ao grupo de usuários do Amazon Cognito. Uma solicitação de registro de usuário bem-sucedida produz um valor de 1, enquanto uma solicitação malsucedida produz um valor de 0. Uma solicitação com controle de utilização também é considerada uma solicitação malsucedida e, portanto, também produzirá uma contagem de 0.

Para descobrir a porcentagem de solicitações de registro de usuário bem-sucedidas, use a estatística Average nessa métrica. Para contar o número total de solicitações de registro de usuário, use a estatística Sample Count nessa métrica. Para contar o número total de solicitações de registro de usuário bem-sucedidas, use a estatística Sum nessa métrica. Para contar o número total de solicitações de registro de usuários que falharam, use a CloudWatch Math expressão e subtraia a Sum estatística da Sample Count estatística.

Essa métrica é publicada por grupo de usuários, para cada cliente de grupo de usuários. Caso o registro de usuário seja realizado por um administrador, a métrica será publicada com o cliente de grupo de usuários como Admin.

Observe que essa métrica não é emitida para casos de Importação de usuários e Migração de usuários.

Dimensão da métrica: UserPool, UserPoolClient

Unidades: contagem

SignUpThrottles

Fornece o número total de solicitações com controle de utilização de registro de usuário feitas ao grupo de usuários do Amazon Cognito. Uma contagem de 1 é publicada sempre que uma solicitação de registro de usuário é limitada.

Para contar o número total de solicitações de registro de usuário limitadas, use a estatística Sum para essa métrica.

Essa métrica é publicada para cada grupo de usuários para cada cliente. Caso a solicitação com controle de utilização tenha sido feita por um administrador, a métrica será publicada com o cliente de grupo de usuários como Admin.

Dimensão da métrica: UserPool, UserPoolClient

Unidades: contagem

SignInSuccesses

Fornece o número total de solicitações bem-sucedidas de autenticação de usuário feitas ao grupo de usuários do Amazon Cognito. Uma autenticação de usuário é considerada bem-sucedida quando o token de autenticação é emitido para o usuário. Uma autenticação bem-sucedida produz um valor de 1, enquanto uma solicitação malsucedida produz um valor de 0. Uma solicitação com controle de utilização também é considerada uma solicitação malsucedida e, portanto, também produzirá uma contagem de 0.

Para descobrir a porcentagem de solicitações de autenticação de usuário bem-sucedidas, use a estatística Average nessa métrica. Para contar o número total de solicitações de autenticação de usuário, use a estatística Sample Count nessa métrica. Para contar o número total de solicitações de autenticação de usuário bem-sucedidas, use a estatística Sum nessa métrica. Para contar o número total de solicitações de autenticação de usuário com falha, use a CloudWatch Math expressão e subtraia a Sum estatística da Sample Count estatística.

Essa métrica é publicada para cada grupo de usuários para cada cliente. Caso um cliente de grupo de usuários inválido seja fornecido com uma solicitação, o valor de cliente de grupo de usuários correspondente na métrica conterá um valor fixo Invalid em vez do valor inválido real enviado na solicitação.

Observe que as solicitações para atualizar o token do Amazon Cognito não estão incluídas nessa métrica. Há uma métrica separada para fornecer estatísticas de token Refresh.

Dimensão da métrica: UserPool, UserPoolClient

Unidades: contagem

SignInThrottles

Fornece o número total de solicitações com controle de utilização de autenticação de usuário feitas ao grupo de usuários do Amazon Cognito. Uma contagem de 1 é publicada sempre que uma solicitação de autenticação de usuário é limitada.

Para contar o número total de solicitações de autenticação de usuário limitadas, use a estatística Sum para essa métrica.

Essa métrica é publicada para cada grupo de usuários para cada cliente. Caso um cliente de grupo de usuários inválido seja fornecido com uma solicitação, o valor de cliente de grupo de usuários correspondente na métrica conterá um valor fixo Invalid em vez do valor inválido real enviado na solicitação.

Solicitações para atualizar o token do Amazon Cognito não estão incluídas nessa métrica. Há uma métrica separada para fornecer estatísticas de token Refresh.

Dimensão da métrica: UserPool, UserPoolClient

Unidades: contagem

TokenRefreshSuccesses

Fornece o número total de solicitações bem-sucedidas para atualizar um token do Amazon Cognito que foram feitas ao grupo de usuários do Amazon Cognito. Uma solicitação bem-sucedida de atualização do token do Amazon Cognito produz um valor de 1, enquanto uma solicitação malsucedida produz um valor de 0. Uma solicitação com controle de utilização também é considerada uma solicitação malsucedida e, portanto, também produzirá uma contagem de 0.

Para descobrir a porcentagem de solicitações bem-sucedidas de atualização de um token do Amazon Cognito, use a estatística Average nessa métrica. Para contar o número total de solicitações de atualização de um token do Amazon Cognito, use a estatística Sample Count nessa métrica. Para contar o número total de solicitações bem-sucedidas de atualização de um token do Amazon Cognito, use a estatística Sum nessa métrica. Para contar o número total de solicitações malsucedidas para atualizar um token do Amazon Cognito, use CloudWatch Math a expressão e subtraia Sum a estatística da estatística. Sample Count

Essa métrica é publicada para cada cliente de grupo de usuários. Se o cliente de um grupo de usuários inválido estiver em uma solicitação, o valor do cliente do grupo de usuários conterá um valor fixo de Invalid.

Dimensão da métrica: UserPool, UserPoolClient

Unidades: contagem

TokenRefreshThrottles

Fornece o número total de solicitações com controle de utilização de atualização de um token do Amazon Cognito que foram feitas para o grupo de usuários do Amazon Cognito. Uma contagem de 1 é publicada sempre que uma solicitação de atualização de token do Amazon Cognito tem controle de utilização.

Para contar o número total de solicitações com controle de utilização para atualizar um token do Amazon Cognito, use a estatística Sum para essa métrica.

Essa métrica é publicada para cada grupo de usuários para cada cliente. Caso um cliente de grupo de usuários inválido seja fornecido com uma solicitação, o valor de cliente de grupo de usuários correspondente na métrica conterá um valor fixo Invalid em vez do valor inválido real enviado na solicitação.

Dimensão da métrica: UserPool, UserPoolClient

Unidades: contagem

FederationSuccesses

Fornece o número total de solicitações bem-sucedidas de federação de identidades feitas ao grupo de usuários do Amazon Cognito. Uma federação de identidades é considerada bem-sucedida quando o Amazon Cognito emite tokens de autenticação para o usuário. Uma solicitação de federação de identidades bem-sucedida produz um valor de 1, enquanto uma solicitação malsucedida produz um valor de 0. Solicitações com controle de utilização e solicitações que geram um código de autorização, mas nenhum token, produzem um valor de 0.

Para descobrir a porcentagem de solicitações de federação de identidades bem-sucedidas, use a estatística Average nessa métrica. Para contar o número total de solicitações de federação de identidades, use a estatística Sample Count nessa métrica. Para contar o número total de solicitações bem-sucedidas de federação de identidades, use a estatística Sum nessa métrica. Para contar o número total de solicitações de federação de identidade com falha, use a CloudWatch Math expressão e subtraia a Sum estatística da Sample Count estatística.

Dimensão de métrica: UserPool, UserPoolClient, IdentityProvider

Unidades: contagem

FederationThrottles

Fornece o número total de solicitações limitadas de federação de identidades feitas ao grupo de usuários do Amazon Cognito. Uma contagem de 1 é publicada sempre que uma solicitação de federação de identidades tem controle de utilização.

Para contar o número total de solicitações de federação de identidades limitadas, use a estatística Sum para essa métrica.

Dimensão de métrica: UserPool, UserPoolClient, IdentityProvider

Unidades: contagem

CallCount

Fornece o número total de chamadas feitas pelos clientes em relação a uma categoria. Essa métrica inclui todas as chamadas, como chamadas com controle de utilização, chamadas com falha e chamadas bem-sucedidas.

Essa métrica está disponível no Usage (Uso) nameSpace.

A cota de categoria é aplicada para cada AWS conta em todos os grupos de usuários em uma conta e região.

Você pode contar o número total de chamadas em uma categoria usando a estatística Sum para essa métrica.

Dimensão métrica: Serviço, Tipo, Recurso, Classe

Unidades: contagem

ThrottleCount

Fornece o número total de chamadas com controle de utilização relacionadas a uma categoria.

Essa métrica está disponível no Usage (Uso) nameSpace.

Essa métrica é publicada no nível da conta.

Você pode contar o número total de chamadas em uma categoria usando a estatística Sum para essa métrica.

Dimensão métrica: Serviço, Tipo, Recurso, Classe

Unidades: contagem

Dimensões dos grupos de usuários do Amazon Cognito

As dimensões a seguir são usadas para refinar as métricas de uso publicadas pelo Amazon Cognito. As dimensões só se aplicam às métricas CallCount e ThrottleCount .

Dimensão Descrição

Serviço

O nome do AWS serviço que contém o recurso. Para as métricas de uso do Amazon Cognito, o valor dessa dimensão é Cognito user pool.

Tipo

O tipo de entidade que está sendo relatado. O único valor válido para as métricas de uso do Amazon Cognito é. API

Recurso

O tipo de recurso que está em execução. O único valor válido é o nome da categoria.

Classe

A classe do recurso sob acompanhamento. O Amazon Cognito não usa a dimensão de classe.

Use o CloudWatch console para monitorar métricas

Você pode rastrear e coletar métricas de grupos de usuários do Amazon Cognito usando. CloudWatch O CloudWatch painel exibirá métricas sobre cada AWS serviço que você usa. Você pode usar CloudWatch para criar alarmes métricos. Os alarmes podem ser configurados para enviar a você notificações ou alterar um recurso específico que você está monitorando. Para visualizar as métricas da cota de serviço em CloudWatch, conclua as etapas a seguir.

  1. Abra o CloudWatchconsole.

  2. No painel de navegação, escolha Metrics (Métricas).

  3. Em All metrics (Todas as métricas), selecione uma métrica e uma dimensão.

  4. Marque a caixa de seleção ao lado de uma métrica. As métricas serão exibidas no gráfico.

nota

As métricas que não tiverem tido novos pontos de dados nas últimas duas semanas não serão exibidas no console. Elas também não serão exibidas quando você digitar o nome da métrica ou os nomes de dimensão na caixa de pesquisa na guia All metrics (Todas as métricas) do console e não serão retornadas nos resultados de um comando list-metrics. A melhor maneira de recuperar essas métricas é com os get-metric-statistics comandos get-metric-data ou no AWS CLI.

Crie um CloudWatch alarme para uma cota

O Amazon Cognito fornece métricas CloudWatch de uso que correspondem às cotas AWS de serviço para e. CallCount ThrottleCount APIs Para obter mais informações sobre o rastreamento do uso em CloudWatch, consulteRastrear o uso da cota.

No console do Service Quotas, é possível criar alarmes que alertarão você quando o uso se aproximar de uma cota de serviço. Para saber como configurar um CloudWatch alarme usando o console Service Quotas, consulte Service Quotas e alarmes. CloudWatch