Observabilidade no Cloud Tasks

A observabilidade do Google Cloud oferece ferramentas de monitorização, registo e diagnóstico. Estas ferramentas podem ajudar a monitorizar e analisar a atividade e o crescimento do Cloud Tasks, bem como a compreender o comportamento, o estado e o desempenho das suas aplicações.

Por predefinição, o Cloud Tasks está configurado para fazer o seguinte:

• Envie dados e registos de auditoria do sistema para o Cloud Logging. Pode usar os registos recolhidos para depurar, resolver problemas e obter estatísticas sobre as suas aplicações.
• Enviar métricas do sistema e de recursos para o Cloud Monitoring. Pode usar as métricas recolhidas para monitorizar o estado de funcionamento e o desempenho, identificar tendências e problemas, e enviar notificações sobre alterações no comportamento.

Envie registos de auditoria para o Cloud Logging

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

• Registos de auditoria da atividade do administrador
• Registos de auditoria de acesso aos dados
• Registos de auditoria de eventos do sistema
• Registos de auditoria de políticas recusadas

Os registos de auditoria de acesso a dados estão desativados por predefinição porque estes registos de auditoria podem ser bastante grandes.

Para mais informações, consulte o artigo Registo de auditoria do Cloud Tasks.

Use o Cloud Logging com filas

Pode usar o Cloud Logging com filas do Cloud Tasks. As seguintes operações são registadas:

• Operações de tarefas:
  • CreateTask
  • DeleteTask
• Tentar operações:
  • AttemptDispatch
  • AttemptResponse

Ative o registo

Pode ativar o registo através da Google Cloud consola ou da CLI do Google Cloud.

Consola

1. Na Google Cloud consola, aceda à página Cloud Tasks > Filas.

   Aceder a Filas

2. Clique no nome da fila para a qual quer ativar o registo.

3. Na página Detalhes da fila, clique no separador Registos.

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

   

gcloud

Para ativar o registo, pode usar 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 o seguinte:

• QUEUE_ID: o ID da sua fila
• LOG_SAMPLING_RATIO: a fração das operações registadas. Qualquer valor entre 1.0 e 0.0 regista essa fração de operações. Para registar todas as operações, defina-o como 1.0. Para não registar operações, defina-o como 0.0 (esta é a predefinição).

Desative o registo

Pode desativar o registo através da Google Cloud consola ou da CLI Google Cloud.

Consola

1. Na Google Cloud consola, aceda à página Cloud Tasks > Filas.

   Aceder a Filas

2. Clique no nome da fila para a qual quer desativar o registo.

3. Na página Detalhes da fila, clique no separador Registos.

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

   

gcloud

Para desativar o registo, use o comando gcloud tasks queues update e defina o sinalizador 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.

Consulte e veja registos

Pode usar as seguintes ferramentas para ver e analisar os seus registos:

• O Explorador de registos foi concebido para ajudar a resolver problemas e analisar o desempenho dos seus serviços e aplicações. Para saber como ver registos no Logs Explorer, siga as instruções em Veja registos através do Logs Explorer.
• O Log Analytics foi concebido para executar consultas para analisar os seus registos e, em seguida, ver ou representar graficamente os resultados. Para saber como usar o Log Analytics, siga as instruções em Consultar e analisar registos com o Log Analytics.

Pode filtrar os registos do Cloud Tasks no Logs Explorer pesquisando cloudtasks no campo de pesquisa.

Para mais informações sobre como consultar e analisar registos, consulte o artigo Consultar e ver registos: vista geral.

Envie métricas para o Cloud Monitoring

O Cloud Tasks envia dados de métricas de recursos monitorizados para o Google Cloud Observability. Um recurso monitorizado no Monitoring representa uma entidade lógica ou física, como uma máquina virtual, uma base de dados ou uma aplicação. Os recursos monitorizados contêm um conjunto único de métricas que podem ser exploradas, comunicadas através de um painel de controlo ou usadas para criar alertas.

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

• cloud_tasks_queues

Cada recurso também tem um conjunto de etiquetas de recursos, que são pares de chave-valor que contêm informações adicionais sobre o recurso. As etiquetas de recursos estão disponíveis para todas as métricas associadas ao recurso e são detalhadas na tabela seguinte.

Métricas e etiquetas de recursos

As strings "metric type" nesta tabela têm de ter o prefixo cloudtasks.googleapis.com/. Esse prefixo foi omitido das entradas na tabela. Ao consultar uma etiqueta, use o prefixo metric.labels.; por exemplo, metric.labels.LABEL="VALUE".

Tipo de métrica ^Fase de lançamento (Níveis da hierarquia de recursos) Nome a apresentar
Kind, Type, Unit Recursos monitorizados	Descrição Etiquetas
api/request_count ^GA  (project) Pedidos API
DELTA, INT64, 1 cloud_tasks_queue	Número de chamadas da API Cloud Tasks. Amostrada a cada 60 segundos. Após a amostragem, os dados não ficam visíveis durante um período máximo de 240 segundos. api_method: O método da 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. Amostrada a cada 60 segundos. Após a amostragem, os dados não ficam visíveis durante um período máximo de 120 segundos.
queue/task_attempt_count ^GA  (project) Contagem de tentativas de tarefas
DELTA, INT64, 1 cloud_tasks_queue	Contagem de tentativas de tarefas discriminadas por código de resposta. Amostrada a cada 60 segundos. Após a amostragem, os dados não ficam visíveis durante um máximo de 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 a hora de tentativa agendada e a hora de tentativa real. Amostrada a cada 60 segundos. Após a amostragem, os dados não ficam visíveis durante um período máximo de 120 segundos.

Tabela gerada a 2025-08-20 20:46:56 UTC.

Para ver todos os tipos de recursos, consulte o artigo Tipos de recursos monitorizados. Para ver todos os tipos de métricas, consulte as Google Cloud métricas.

Ler dados de métricas

Pode ler dados de métricas, também denominados dados de séries cronológicas, através do método timeSeries.list na API Cloud Monitoring. Existem várias formas de chamar o método, incluindo a utilização de uma biblioteca de cliente específica do idioma ou a criação de um gráfico com o Explorador de métricas. Para uma introdução às métricas e às séries cronológicas, consulte o artigo Métricas, séries cronológicas e recursos. Para saber como ler os dados das métricas, consulte Obtenha dados de séries cronológicas.

Use painéis de controlo e alertas de monitorização

Pode usar os painéis de controlo de monitorização e os respetivos gráficos associados para visualizar os dados das métricas do Cloud Tasks.

Para monitorizar estas métricas na Monitorização, pode criar painéis de controlo personalizados. Também pode adicionar alertas com base nestas métricas.