Monitorize fluxos de trabalho

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

Por predefinição, o Workflows 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

Os fluxos de trabalho enviam os seguintes tipos de dados de registo de auditoria para o Cloud Logging:

Os registos de auditoria de acesso a dados estão desativados por predefinição porque podem ser bastante grandes. Para mais informações, consulte o artigo Ative os registos de auditoria de acesso a dados.

Para mais informações sobre os registos de auditoria nos fluxos de trabalho, consulte o seguinte:

Também pode enviar registos de execução para o Cloud Logging.

Envie métricas para o Cloud Monitoring

Os fluxos de trabalho enviam 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. 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.

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. Expanda o seguinte para ver uma lista dos tipos de métricas enviadas dos fluxos de trabalho para o Google Cloud Observability:

Tipos de métricas do Workflows

As strings "metric type" nesta tabela têm de ter o prefixo workflows.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
await_callback_step_count GA  (project)
Await Callback Step Count
DELTA, INT64, 1
workflows.googleapis.com/Workflow 		Número de passos executados que aguardam uma chamada de retorno. 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.
revision_id: O ID de revisão do fluxo de trabalho executado.
callback_requests_count GA  (project)
Contagem de pedidos de chamadas de retorno
DELTA, INT64, 1
workflows.googleapis.com/Workflow 		Número de pedidos feitos para acionar um callback. 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.
revision_id: O ID de revisão do fluxo de trabalho executado.
callback_timeout_count GA  (project)
Callback Timeout Count
DELTA, INT64, 1
workflows.googleapis.com/Workflow 		Número de retornos de chamada que excederam o tempo limite. 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.
revision_id: O ID de revisão do fluxo de trabalho executado.
cmek_protected_workflow_count GA  (project)
CMEK Protected Workflow Count
DELTA, INT64, 1
workflows.googleapis.com/Workflow 		Número de fluxos de trabalho implementados com proteção CMEK. 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.
revision_id: O ID de revisão do fluxo de trabalho executado.
compute_slice_count GA  (project)
Compute Slice Count
DELTA, INT64, 1
workflows.googleapis.com/Workflow 		Número de fatias de computação executadas. Os passos são executados em partes do trabalho, o que depende do tipo de passos que estão a ser executados (por exemplo, os pedidos HTTP são executados separadamente dos passos "assign"). 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.
revision_id: O ID de revisão do fluxo de trabalho executado.
type: O tipo de fatia de computação, como "IO_REQUEST" ou "WAKEUP".
has_parallel: (BOOL) Indica se o fluxo de trabalho usa passos paralelos.
compute_slice_latencies GA  (project)
Latências de divisão de computação
DELTA, DISTRIBUTION, ms
workflows.googleapis.com/Workflow 		Latências desde o momento em que uma fatia de computação foi agendada até ao momento em que foi executada. 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.
revision_id: O ID de revisão do fluxo de trabalho executado.
type: O tipo de fatia de computação, como "IO_REQUEST" ou "WAKEUP".
has_parallel: (BOOL) Indica se o fluxo de trabalho usa passos paralelos.
compute_step_count GA  (project)
Calcular contagem de passos
DELTA, INT64, 1
workflows.googleapis.com/Workflow 		Número de passos de computação executados (por exemplo, passos "assign" e "for"). 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.
revision_id: O ID de revisão do fluxo de trabalho executado.
compute_step_latencies GA  (project)
Latências do passo de computação
DELTA, DISTRIBUTION, ms
workflows.googleapis.com/Workflow 		Latências dos passos de computação executados. 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.
revision_id: O ID de revisão do fluxo de trabalho executado.
create_callback_step_count GA  (project)
Create Callback Step Count
DELTA, INT64, 1
workflows.googleapis.com/Workflow 		Número de passos executados que criam um retorno de chamada. 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.
revision_id: O ID de revisão do fluxo de trabalho executado.
method: O tipo de método do callback criado, como "POST".
deployment_attempt_count GA  (projeto)
Deployment Attempt Count
DELTA, INT64, 1
workflows.googleapis.com/Workflow 		Número de tentativas de implementação do fluxo de trabalho. 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.
revision_id: O ID de revisão do fluxo de trabalho executado.
result: O estado das tentativas de implementação.
deployment_latencies GA  (projeto)
Latências de implementação
DELTA, DISTRIBUTION, ms
workflows.googleapis.com/Workflow 		Latências das tentativas de implementação do fluxo de trabalho. 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.
revision_id: O ID de revisão do fluxo de trabalho executado.
duplicate_event_count GA  (projeto)
Contagem de eventos duplicados
DELTA, INT64, 1
workflows.googleapis.com/Workflow 		Número de acionadores de eventos duplicados recebidos. 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.
revision_id: O ID de revisão do fluxo de trabalho executado.
event_type: O tipo do evento.
event_time_to_ack_latencies GA  (project)
Latências de tempo de evento para confirmação
DELTA, DISTRIBUTION, ms
workflows.googleapis.com/Workflow 		Latências desde o momento em que um evento começa até ao momento em que o serviço de fluxos de trabalho o confirma. 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.
revision_id: O ID de revisão do fluxo de trabalho executado.
event_type: O tipo do evento.
event_trigger_count GA  (project)
Contagem de acionadores de eventos
DELTA, INT64, 1
workflows.googleapis.com/Workflow 		Número de acionadores de eventos recebidos. 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.
revision_id: O ID de revisão do fluxo de trabalho executado.
event_type: O tipo do evento.
result: O resultado do acionador de eventos.
execution_backlog_size GA  (project)
Tamanho da fila de execução
GAUGE, INT64, 1
workflows.googleapis.com/Workflow 		Número de execuções que ainda não foram iniciadas. 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.
revision_id: O ID de revisão do fluxo de trabalho executado.
execution_times BETA  (project)
Tempos de execução
DELTA, DISTRIBUTION, s
workflows.googleapis.com/Workflow 		Distribuição dos tempos de execução do fluxo de trabalho.
revision_id: O ID de revisão do fluxo de trabalho executado.
external_step_count BETA  (project)
External step count
DELTA, INT64, 1
workflows.googleapis.com/Workflow 		Contagem de passos externos executados para o fluxo de trabalho.
finished_execution_count BETA  (project)
Finished execution count
DELTA, INT64, 1
workflows.googleapis.com/Workflow 		Número de execuções concluídas para o fluxo de trabalho.
status: O estado de execução do fluxo de trabalho.
revision_id: O ID de revisão do fluxo de trabalho executado.
internal_execution_error_count GA  (project)
Internal Execution Error Count
DELTA, INT64, 1
workflows.googleapis.com/Workflow 		Número de execuções que falharam com um erro interno. 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.
revision_id: O ID de revisão do fluxo de trabalho executado.
internal_step_count BETA  (project)
Internal step count
DELTA, INT64, 1
workflows.googleapis.com/Workflow 		Contagem de passos internos executados para o fluxo de trabalho.
io_internal_request_count GA  (project)
IO Internal Request Count
DELTA, INT64, 1
workflows.googleapis.com/Workflow 		Número de pedidos de E/S feitos por um fluxo de trabalho aos serviços Google. 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.
revision_id: O ID de revisão do fluxo de trabalho executado.
service_domain: O domínio do serviço Google que está a ser chamado, como "bigquery.googleapis.com".
io_step_count GA  (project)
Contagem de passos de IO
DELTA, INT64, 1
workflows.googleapis.com/Workflow 		Número de passos de E/S executados. 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.
revision_id: O ID de revisão do fluxo de trabalho executado.
io_result: O resultado do passo de E/S.
io_step_type: O tipo de passo de I/O.
destination_type: O tipo de destino do passo de I/O.
had_system_error: (BOOL) Indica se o passo de E/S teve um erro do sistema.
io_step_latencies GA  (project)
Latências do passo de E/S
DELTA, DISTRIBUTION, ms
workflows.googleapis.com/Workflow 		Latências dos passos de E/S executados. 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.
revision_id: O ID de revisão do fluxo de trabalho executado.
io_result: O resultado do passo de E/S.
io_step_type: O tipo de passo de I/O.
had_system_error: (BOOL) Indica se o passo de E/S teve um erro do sistema.
kms_decrypt_latencies GA  (project)
Latências de desencriptação do KMS
DELTA, DISTRIBUTION, ms
workflows.googleapis.com/Workflow 		Latências de pedidos de desencriptação para o KMS por fluxos de trabalho para CMEK. 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.
revision_id: O ID de revisão do fluxo de trabalho executado.
status: O estado dos pedidos de desencriptação.
attempts: (INT64) A contagem de tentativas dos pedidos de desencriptação.
kms_decrypt_request_count GA  (project)
KMS Decrypt Request Count
DELTA, INT64, 1
workflows.googleapis.com/Workflow 		Número de pedidos de desencriptação do KMS feitos pelo serviço para CMEK. 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.
revision_id: O ID de revisão do fluxo de trabalho executado.
status: O estado dos pedidos de desencriptação.
kms_encrypt_latencies GA  (project)
Latências de encriptação do KMS
DELTA, DISTRIBUTION, ms
workflows.googleapis.com/Workflow 		Latências de pedidos de encriptação para o KMS por fluxos de trabalho para CMEK. 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.
revision_id: O ID de revisão do fluxo de trabalho executado.
status: O estado dos pedidos de encriptação.
attempts: (INT64) O número de tentativas dos pedidos de encriptação.
kms_encrypt_request_count GA  (project)
KMS Encrypt Request Count
DELTA, INT64, 1
workflows.googleapis.com/Workflow 		Número de pedidos de encriptação do KMS feitos pelo serviço para CMEK. 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.
revision_id: O ID de revisão do fluxo de trabalho executado.
status: O estado dos pedidos de encriptação.
parallel_branch_step_count GA  (project)
Contagem de passos da ramificação paralela
DELTA, INT64, 1
workflows.googleapis.com/Workflow 		Número de passos executados com ramificações paralelas. 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.
revision_id: O ID de revisão do fluxo de trabalho executado.
parallel_branch_substep_count GA  (projeto)
Contagem de subpassos de ramificação paralela
DELTA, INT64, 1
workflows.googleapis.com/Workflow 		Número de passos executados em ramificações paralelas. 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.
revision_id: O ID de revisão do fluxo de trabalho executado.
parallel_iteration_step_count GA  (project)
Parallel iteration step count
DELTA, INT64, 1
workflows.googleapis.com/Workflow 		Número de passos executados com iterações paralelas. 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.
revision_id: O ID de revisão do fluxo de trabalho executado.
parallel_iteration_substep_count GA  (project)
Parallel iteration substep count
DELTA, INT64, 1
workflows.googleapis.com/Workflow 		Número de passos executados em iterações paralelas. 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.
revision_id: O ID de revisão do fluxo de trabalho executado.
parallel_unhandled_exceptions_limit_count GA  (project)
Parallel unhandled exceptions limit count
DELTA, INT64, 1
workflows.googleapis.com/Workflow 		Número de vezes que o limite de exceções paralelas não processadas foi atingido. 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.
revision_id: O ID de revisão do fluxo de trabalho executado.
pending_io_requests GA  (project)
Pedidos de IO pendentes
GAUGE, INT64, 1
workflows.googleapis.com/Workflow 		Número de pedidos de E/S em curso. 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.
revision_id: O ID de revisão do fluxo de trabalho executado.
sent_bytes_count BETA  (project)
Bytes de rede enviados
DELTA, INT64, By
workflows.googleapis.com/Workflow 		Contagem de bytes HTTP de saída (URL, cabeçalhos e corpo) enviados pelo fluxo de trabalho.
revision_id: O ID de revisão do fluxo de trabalho executado.
started_execution_count BETA  (project)
Started execution count
DELTA, INT64, 1
workflows.googleapis.com/Workflow 		Contagem de execuções iniciadas para o fluxo de trabalho.
revision_id: O ID de revisão do fluxo de trabalho executado.
started_vpcsc_executions_count GA  (projeto)
Started VPC-SC Executions Count
DELTA, INT64, 1
workflows.googleapis.com/Workflow 		Número de execuções restritas da VPC-SC iniciadas. 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.
revision_id: O ID de revisão do fluxo de trabalho executado.
vpcsc_protected_io_count GA  (project)
VPC-SC Protected IO Count
DELTA, INT64, 1
workflows.googleapis.com/Workflow 		Número de pedidos de E/S feitos através do VPC-SC. Amostrados a cada 60 segundos. Após a amostragem, os dados não ficam visíveis durante um período máximo de 120 segundos.
revision_id: O ID de revisão do fluxo de trabalho executado.

Tabela gerada a 08-08-2025 às 23:40:45 UTC.

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 cliente específica do idioma ou a criação de um gráfico com o Explorador de métricas.Também pode experimentar o método timeSeries.list através do Explorador de APIs baseado em formulários. 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.

Monitorize as métricas de quota

O exemplo seguinte demonstra como usar o Explorador de APIs para consultar a quota de alocação total consumida para fluxos de trabalho. Especificamente, usa a métrica serviceruntime.googleapis.com/quota/allocation/usage no tipo de recurso Consumer Quota. Pode definir filtros de etiquetas adicionais (service, quota_metric) para especificar o tipo de quota. Para mais informações sobre como monitorizar as métricas de quota, incluindo mais exemplos e como criar políticas de alerta, consulte Represente graficamente e monitorize as métricas de quota.

  1. Abra a timeSeries.list página de referência.

  2. Se o painel Experimentar este método não estiver visível, clique em Experimentar!

  3. No campo nome, introduza o seu Google Cloud ID do projeto com o seguinte formato:

    projects/PROJECT_ID

  4. No campo filtro, especifique um único tipo de métrica e, opcionalmente, etiquetas de métricas e outras informações. Por exemplo:

    metric.type = "serviceruntime.googleapis.com/quota/allocation/usage" AND resource.labels.service = "workflowexecutions.googleapis.com"

  5. No campo interval.endTime, introduza uma hora de fim para limitar a quantidade de dados devolvidos, e que é aplicável à sua utilização. Deve ser formatado como uma string RFC 3339; por exemplo, 2024-11-07T03:01:02Z.

  6. No campo interval.startTime, introduza uma hora de início para limitar a quantidade de dados devolvidos, e que é aplicável à sua utilização. Deve ser formatado como uma string RFC 3339; por exemplo, 2024-11-07T03:01:00Z.

  7. Clique em Executar.

    O resultado deve ser semelhante ao seguinte, com 350 a indicar a métrica de quota de execuções simultâneas.

    {
"timeSeries": [
   {
      "metric": {
      "labels": {
         "quota_metric": "workflowexecutions.googleapis.com/concurrency"
      },
      "type": "serviceruntime.googleapis.com/quota/allocation/usage"
      },
      "resource": {
      "type": "consumer_quota",
      "labels": {
         "service": "workflowexecutions.googleapis.com",
         "project_id": "PROJECT_ID",
         "location": "europe-west1"
      }
      },
      "metricKind": "GAUGE",
      "valueType": "INT64",
      "points": [
      {
         "interval": {
            "startTime": "2024-11-07T03:01:02Z",
            "endTime": "2024-11-07T03:01:02Z"
         },
         "value": {
            "int64Value": "350"
         }
      }
      ]
   }

  8. No painel lateral do Explorador de APIs reduzido, pode clicar em Ecrã inteiro para expandir o Explorador de APIs. O painel de ecrã inteiro apresenta um painel adicional com exemplos de código, respostas application/json e respostas HTTP não processadas. Por exemplo, neste caso, pode ver o comando curl comparável:

    curl \
'https://monitoring.googleapis.com/v3/projects/PROJECT_ID/timeSeries?filter=metric.type%20%3D%20%22serviceruntime.googleapis.com%2Fquota%2Fallocation%2Fusage%22%20AND%20resource.labels.service%20%3D%20%22workflowexecutions.googleapis.com%22&interval.endTime=2024-11-07T03%3A01%3A02Z&interval.startTime=2024-11-07T03%3A01%3A00Z&key=YOUR_API_KEY' \
   --header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
   --header 'Accept: application/json' \
   --compressed

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 de fluxos de trabalho.

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.

O que se segue?