Observabilidade no Cloud Tasks

O Google Cloud Observability oferece ferramentas de monitoramento, geração de registros e diagnóstico. Essas ferramentas ajudam a monitorar e analisar a atividade e o crescimento do Cloud Tasks, além de entender o comportamento, a integridade e o desempenho dos 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.
  • Envie métricas de sistema e 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
  • Operações de tentativa:
    • AttemptDispatch
    • AttemptResponse

Ativar a geração de registros

É possível ativar o registro em registros usando o console Google Cloud ou a Google Cloud CLI.

Console

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

    Acessar "Filas"

  2. Clique no nome da fila em que você quer 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 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 sua 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 não registrar operações, defina como 0.0 (padrão).

Desative a geração de registros

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

Console

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

    Acessar "Filas"

  2. Clique no nome da fila em que você quer desativar o registro em registros.

  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 sua fila.

Consultar e exibir registros

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

  • O Explorador de registros 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 registros foi projetada para executar consultas e analisar seus registros e, em seguida, conferir ou criar gráficos 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.

Para filtrar os registros do Cloud Tasks na Análise de registros, pesquise cloudtasks no campo de pesquisa.

Para mais informações sobre como consultar e analisar registros, consulte 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 o Google Cloud Observability. Um recurso monitorado no Monitoring 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 analisadas, 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 tarefa
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 de tentativa de tarefa
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 08-08-2025 23:40:45 UTC.

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

Ler dados de métricas

É possível ler dados de métricas, 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 a criação de 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 Recuperar dados de série temporal.

Usar painéis e alertas do Monitoring

É possível usar os painéis do Monitoring e os 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.