Observabilidade no Cloud Tasks

O Google Cloud Observability oferece ferramentas de monitoramento, geração de registros e diagnóstico. Essas ferramentas podem ajudar a monitorar e analisar a atividade e o crescimento do Cloud Tasks, além de entender o comportamento, a integridade e o desempenho dos seus aplicativos.

Por padrão, o Cloud Tasks é configurado para fazer o seguinte:

  • Envie dados e registros de auditoria do sistema para o Cloud Logging. É possível usar os registros coletados para depurar, resolver problemas e ter insights sobre seus aplicativos.
  • Enviar métricas do sistema e dos recursos para o Cloud Monitoring. É possível usar as métricas coletadas para monitorar a integridade e o desempenho, identificar tendências e problemas e notificar mudanças no comportamento.

Enviar registros de auditoria para o Cloud Logging

O Cloud Tasks envia os seguintes tipos de dados de registro de auditoria para o Cloud Logging:

Os registros de auditoria de acesso a dados estão desativados por padrão porque podem ser muito grandes.

Para mais informações, consulte Registro de auditoria do Cloud Tasks.

Usar o Cloud Logging com filas

É possível usar o Cloud Logging com filas do Cloud Tasks. As seguintes operações são registradas:

  • Operações de tarefa:
    • CreateTask
    • DeleteTask
  • Tentativas de operações:
    • AttemptDispatch
    • AttemptResponse

Ativar a geração de registros

É possível ativar a geração de registros usando o console do Google Cloud ou a CLI do Google Cloud.

Console

  1. No console do Google Cloud, acesse a página Cloud Tasks > Queues.

    Acessar filas

  2. Clique no nome da fila para ativar o registro.

  3. Na página Detalhes da fila, clique na guia Registros.

  4. Clique em Ativar registros e, para confirmar, clique em Ativar.

    captura de tela

gcloud

Para ativar a geração de registros, use o comando gcloud tasks queues create ou o comando gcloud tasks queues update.

gcloud tasks queues create QUEUE_ID \
    --log-sampling-ratio=LOG_SAMPLING_RATION

ou

gcloud tasks queues update QUEUE_ID \
    --log-sampling-ratio=LOG_SAMPLING_RATIO

Substitua:

  • QUEUE_ID: o ID da fila
  • LOG_SAMPLING_RATIO: a fração das operações registradas. Qualquer valor entre 1.0 e 0.0 registra essa fração de operações. Para registrar todas as operações, defina como 1.0. Para registrar nenhuma operação, defina como 0.0 (padrão).

Desative a geração de registros

É possível desativar a geração de registros usando o console do Google Cloud ou a CLI do Google Cloud.

Console

  1. No console do Google Cloud, acesse a página Cloud Tasks > Queues.

    Acessar filas

  2. Clique no nome da fila para desativar o registro.

  3. Na página Detalhes da fila, clique na guia Registros.

  4. Clique no ícone de reticências > Desativar registros. Para confirmar, clique em Desativar.

    captura de tela

gcloud

Para desativar o registro, use o comando gcloud tasks queues update e defina a flag log-sampling-ratio como 0.0.

gcloud tasks queues update QUEUE_ID \
    --log-sampling-ratio=0.0

Substitua QUEUE_ID pelo ID da fila.

Consultar e exibir registros

Use as ferramentas a seguir para conferir e analisar seus registros:

  • O Logs Explorer foi criado para ajudar você a resolver problemas e analisar o desempenho dos seus serviços e aplicativos. Para saber como visualizar registros no Explorador de registros, siga as instruções em Ver registros usando o Explorador de registros.
  • A Análise de dados de registros foi projetada para executar consultas e analisar seus registros, e depois conferir ou gerar um gráfico com os resultados. Para saber como usar a Análise de Registros, siga as instruções em Consultar e analisar registros com a Análise de Registros.

É possível filtrar os registros da Cloud Tasks no Logs Explorer procurando por cloudtasks no campo de pesquisa.

Para mais informações sobre como consultar e analisar registros, consulte a Visão geral de consultas e registros de registros.

Enviar métricas para o Cloud Monitoring

O Cloud Tasks envia dados de métricas de recursos monitorados para a Google Cloud Observability. Um recurso monitorado no monitoramento representa uma entidade lógica ou física, como uma máquina virtual, um banco de dados ou um aplicativo. Os recursos monitorados contêm um conjunto exclusivo de métricas que podem ser acessados, informadas em um painel ou usadas para criar alertas.

O Cloud Tasks envia dados de métricas do seguinte recurso monitorado para o Google Cloud Observability:

Cada recurso também tem um conjunto de rótulos, que são pares de chave-valor que contêm informações adicionais sobre o recurso. Os rótulos de recursos estão disponíveis para todas as métricas associadas ao recurso e são detalhados na tabela a seguir.

Métricas e rótulos de recursos

As strings "tipo de métrica" nesta tabela precisam ser prefixadas com cloudtasks.googleapis.com/. Esse prefixo foi omitido das entradas na tabela. Ao consultar um rótulo, use o prefixo metric.labels.. por exemplo, metric.labels.LABEL="VALUE".

Tipo de métrica Etapa do lançamento (níveis da hierarquia de recursos)
Nome de exibição
Classe, Tipo, Unidade
Recursos monitorados		 Descrição
Rótulos
api/request_count GA  (projeto)
Solicitações de API
DELTA, INT64, 1
cloud_tasks_queue 		Contagem de chamadas da API Cloud Tasks. Amostras coletadas a cada 60 segundos. Após a amostragem, os dados não são visíveis por até 240 segundos.
api_method: O método de API chamado (por exemplo, CreateTask).
response_code: código de resposta canônico como string (por exemplo, "ok").
queue/depth GA  (projeto)
Profundidade da fila
GAUGE, INT64, 1
cloud_tasks_queue 		O número de tarefas na fila. Amostras coletadas a cada 60 segundos. Após a amostragem, os dados não são visíveis por até 120 segundos.
queue/task_attempt_count GA  (projeto)
Contagem de tentativas de tarefas
DELTA, INT64, 1
cloud_tasks_queue 		Contagem de tentativas da tarefa discriminadas por código de resposta. Amostras coletadas a cada 60 segundos. Após a amostragem, os dados não são visíveis por até 180 segundos.
response_code: código de resposta canônico como string (por exemplo, "ok").
queue/task_attempt_delays GA  (projeto)
Atrasos na tentativa de tarefas
DELTA, DISTRIBUTION, ms
cloud_tasks_queue 		Atraso entre cada horário de tentativa programado e o horário de tentativa real. Amostras coletadas a cada 60 segundos. Após a amostragem, os dados não são visíveis por até 120 segundos.

Tabela gerada em 24-01-2025 16:56:52 UTC.

Para conferir todos os tipos de recursos, consulte Tipos de recursos monitorados. Para conferir todos os tipos de métricas, consulte métricasGoogle Cloud .

Ler dados de métricas

É possível ler dados de métrica, também chamados de dados de série temporal, usando o método timeSeries.list na API Cloud Monitoring. Há várias maneiras de chamar o método, incluindo o uso de uma biblioteca de cliente específica da linguagem ou criando um gráfico com o Metrics Explorer. Para uma introdução a métricas e série temporal, consulte Métricas, série temporal e recursos. Para saber como ler os dados de métricas, consulte Extrair dados de séries temporais.

Usar painéis e alertas do Monitoring

É possível usar os painéis de monitoramento e os respectivos gráficos associados para visualizar os dados das métricas do Cloud Tasks.

Para monitorar essas métricas no Monitoring, é possível criar painéis personalizados. Você também pode adicionar alertas com base nessas métricas.