Observabilidade no Cloud Tasks

O Google Cloud Observability oferece ferramentas de monitoramento, geração de registros e diagnóstico Essas ferramentas podem ajudar você 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:

  • Enviar dados e registros de auditoria do sistema ao Cloud Logging. É possível usar os registros coletados para depurar, resolver problemas e ter insights sobre seus aplicativos.
  • Enviar métricas de recursos e do sistema ao 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 ao Cloud Logging

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

Os registros de auditoria de acesso a dados estão desativados por padrão porque estes registros de auditoria 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 a geração de registros usando o Google Cloud console ou a Google Cloud CLI.

Console

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

    Acessar filas

  2. Clique no nome da fila em que você quer ativar a geração de registros.

  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 gcloud tasks queues create ou o gcloud tasks queues update comando.

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 não 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 Google Cloud console ou a Google Cloud CLI.

Console

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

    Acessar filas

  2. Clique no nome da fila em que você quer desativar a geração de 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 a geração de registros, use o gcloud tasks queues update comando 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 visualizar e analisar seus registros:

  • O Análise 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 na Análise de registros, siga as instruções em Visualizar registros usando a Análise de registros.
  • O Observability Analytics foi criado para executar consultas para analisar seus registros e, em seguida, visualizar ou representar graficamente os resultados. Para saber como usar o Observability Analytics, siga as instruções em Consultar e analisar registros com o Observability Analytics.

É possível filtrar os registros do Cloud Tasks na Análise de registros pesquisando 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 ao 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, exibidas 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 de recurso, que são pares de chave-valor com 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 ficam 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 ficam visíveis por até 120 segundos.
queue/task_attempt_count GA  (projeto)
Contagem de tentativas da 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 ficam 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 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 ficam visíveis por até 120 segundos.

Tabela gerada em 02-04-2026 02:29:29 UTC.

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

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 ver uma introdução a métricas e série temporal, acesse 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.