O painel de observabilidade do armazenamento em memória fornece gráficos em tempo real sobre o uso da memória e solicitações de API. Ele também possui um sistema de alerta integrado que notifica você por e-mail quando um problema surge, ajudando você a solucionar problemas em sincronia. Para mais informações sobre erros específicos, você pode visualizar seu Relatório de Erros para encontrar os logs de erro.
Acesse o painel
O painel de observabilidade do armazenamento em memória está disponível para qualquer jogo que utilize MemoryStoreService, mas você deve ser o proprietário do jogo ou ter permissões de grupo de análise para acessar o painel.
Para acessar o painel:
- Navegue até a página de Criações no Painel do Criador.
- Expanda o seletor de conta no canto superior esquerdo e selecione sua conta ou o grupo proprietário do jogo alvo.
- Selecione o jogo.
- No menu suspenso Monitoramento, selecione Armazenamentos em Memória.
Gráficos disponíveis
O painel inclui duas categorias de gráficos de linha:
- Gráficos de Uso de Cota para rastrear seu uso em comparação com as cotas alocadas dinamicamente, que são calculadas com base no número de usuários em seu jogo.
- Uso de Memória sobre seu uso de memória por minuto em bytes comparado a quanto da sua cota alocada restou.
- Unidade de Solicitação de API sobre suas unidades de solicitação totais por minuto comparado a quanto da sua cota alocada restou. Este gráfico pode ser detalhado por cada método de API.
- Gráficos de Uso e Desempenho da API para monitorar o padrão de uso da API e o desempenho com base no método de API e no status da resposta.
- Contagem de Solicitações por API sobre a contagem de solicitações de API por minuto por método de API, como MemoryStoreQueue:ReadAsync() ou MemoryStoreSortedMap:UpdateAsync().
- Contagem de Solicitações por Status sobre a contagem de solicitações de API por status de resposta.
- Solicitação por API x Status sobre os status de resposta retornados por todos ou um método de API específico.
O gráfico contém dados dos últimos 30 dias, e você pode selecionar um intervalo de tempo personalizado com o seletor no topo da página. Se você selecionar um intervalo de tempo anterior a 30 dias, o sistema retornará um erro Solicitação Falhou.
Códigos de status de resposta
Os gráficos Contagem de Solicitações por Status e Solicitações por API x Status do Painel de Observabilidade incluem códigos de status das respostas da API que você pode usar para entender e solucionar erros. Para uma tabela que lista e descreve todos esses códigos de status, veja Observabilidade. Além disso, para informações sobre como resolver esses erros, ou a cota ou limitação específica à qual um erro se relaciona, veja Solução de Problemas e Limites e Cotas, respectivamente.
Alertas de notificação
O sistema de alerta por e-mail detecta automaticamente e envia alertas sobre problemas de uso do armazenamento em memória que podem prejudicar o desempenho do seu jogo. Existem dois tipos de alertas:
- Avisos são alertas com prioridade mais baixa sobre problemas que podem potencialmente impactar seu jogo. Você deve resolvê-los antes que se tornem problemas críticos. O painel sinaliza esses alertas destacando o gráfico em amarelo com uma mensagem de aviso.
- Críticos são alertas com prioridade mais alta sobre problemas que impactam diretamente seu jogo. Você deve resolver esses problemas o mais rápido possível para evitar desempenho degradado. O painel sinaliza esses alertas destacando o gráfico em vermelho com uma mensagem de erro.
Quando seu jogo aciona dois tipos de alertas ao mesmo tempo, o painel exibe a mensagem do cabeçalho do alerta e destaca a região do gráfico para sua atenção como Crítico.
Atualmente, o sistema possui quatro alertas integrados para uso de memória e solicitações de API. Se seu jogo exceder um limite de alerta, o sistema notifica você no máximo uma vez por dia para cada alerta. Ao receber um alerta por e-mail, você deve visualizar o painel e tomar ações para evitar desempenho degradado.
Alertas de uso de memória
O sistema envia os seguintes alertas de uso de memória:
Um alerta de Aviso quando o uso de memória do seu jogo excedeu 70% da cota total dentro da última hora.
Um alerta de Crítico quando seu jogo excedeu a cota de tamanho de memória na última hora.
Esses problemas geralmente ocorrem quando você superpopula uma estrutura de dados do armazenamento em memória com muitos dados, o que pode consumir a cota rapidamente mesmo que você envie solicitações em apenas algumas chaves. Por exemplo, se você definir um longo tempo de expiração em chaves ou não limpar os dados processados, dados extras podem preencher sua cota de memória.
Para prevenir e resolver esses problemas, aplique melhores práticas para manter o controle das estruturas de dados que você está utilizando ativamente e configure um mecanismo para limpar os dados processados.
Alertas de solicitações de API
O sistema envia os seguintes alertas de solicitações de API:
Um alerta de Crítico quando o número de falhas de solicitação do seu armazenamento em memória excedeu 20% na última hora.
Um alerta de Crítico quando mais de 10% das suas solicitações de armazenamento em memória estão sendo limitadas na última hora.
- Este alerta é baseado no número de DataStructureRequestsOverLimit + TotalRequestsOverLimit, que são respostas de erro indicando que seu jogo está limitado porque envia muitas solicitações.
- Este alerta não está relacionado ao tamanho da solicitação, apenas à quantidade.
Todas as solicitações de API têm códigos de status de resposta correspondentes, para que você possa visualizar a proporção de respostas Bem-sucedidas em relação a todas as respostas de erro usando o gráfico Contagem de Solicitações por Status para solução de problemas.
