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 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 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: 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 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 Dimensão da métrica: 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 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 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 Dimensão da métrica: 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 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 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 Dimensão da métrica: 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 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 Dimensão da métrica: 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 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 Dimensão da métrica: 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 Dimensão de métrica: 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 Dimensão de métrica: 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) 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 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) 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 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 é |
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.
-
Abra o CloudWatchconsole
. -
No painel de navegação, escolha Metrics (Métricas).
-
Em All metrics (Todas as métricas), selecione uma métrica e uma dimensão.
-
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