Monitorar fluxos de trabalho

O Google Cloud Observability oferece ferramentas de monitoramento, geração de registros e diagnóstico. Essas ferramentas ajudam a monitorar e analisar implantações e execuções de fluxos de trabalho, além de entender o comportamento, a integridade e a performance dos aplicativos.

Por padrão, o Workflows é 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 Workflows 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 Ativar registros de auditoria de acesso a dados.

Para mais informações sobre registros de auditoria no Workflows, consulte o seguinte:

Também é possível enviar registros de execução para o Cloud Logging.

Enviar métricas para o Cloud Monitoring

Workflows enviam 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. Cada recurso também tem um conjunto de rótulos, 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 a ele.

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

Tipos de métricas do Workflows

As strings "tipo de métrica" nesta tabela precisam ser prefixadas com workflows.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
await_callback_step_count GA  (projeto)
Contagem de etapas de retorno de chamada de espera
DELTA, INT64, 1
workflows.googleapis.com/Workflow 		Número de etapas executadas que aguardam um callback. Amostras coletadas a cada 60 segundos. Após a amostragem, os dados não são visíveis por até 120 segundos.
revision_id: O ID da revisão do fluxo de trabalho executado.
callback_requests_count GA  (projeto)
Contagem de solicitações de callback
DELTA, INT64, 1
workflows.googleapis.com/Workflow 		Número de solicitações feitas para acionar um callback. Amostras coletadas a cada 60 segundos. Após a amostragem, os dados não são visíveis por até 120 segundos.
revision_id: O ID da revisão do fluxo de trabalho executado.
callback_timeout_count GA  (projeto)
Contagem de tempo limite de retorno de chamada
DELTA, INT64, 1
workflows.googleapis.com/Workflow 		Número de callbacks que expiraram. Amostras coletadas a cada 60 segundos. Após a amostragem, os dados não são visíveis por até 120 segundos.
revision_id: O ID da revisão do fluxo de trabalho executado.
cmek_protected_workflow_count GA  (projeto)
Contagem de fluxos de trabalho protegidos por CMEK
DELTA, INT64, 1
workflows.googleapis.com/Workflow 		Número de fluxos de trabalho implantados com proteção de CMEK. Amostras coletadas a cada 60 segundos. Após a amostragem, os dados não são visíveis por até 120 segundos.
revision_id: O ID da revisão do fluxo de trabalho executado.
compute_slice_count GA  (projeto)
Contagem de intervalos de computação
DELTA, INT64, 1
workflows.googleapis.com/Workflow 		Número de intervalos de computação executados. As etapas são executadas em partes de trabalho, o que depende do tipo de etapa em execução. Por exemplo, as solicitações HTTP são executadas separadamente das etapas de atribuição. Amostras coletadas a cada 60 segundos. Após a amostragem, os dados não são visíveis por até 120 segundos.
revision_id: O ID da revisão do fluxo de trabalho executado.
type: O tipo de fração de computação, como "IO_REQUEST" ou "WAKEUP".
has_parallel: (BOOL) Se o fluxo de trabalho usa etapas paralelas.
compute_slice_latencies GA  (projeto)
Latências de fração de computação
DELTA, DISTRIBUTION, ms
workflows.googleapis.com/Workflow 		Latências desde o momento em que uma fração de computação foi programada até o momento em que foi executada. Amostras coletadas a cada 60 segundos. Após a amostragem, os dados não são visíveis por até 120 segundos.
revision_id: O ID da revisão do fluxo de trabalho executado.
type: O tipo de fração de computação, como "IO_REQUEST" ou "WAKEUP".
has_parallel: (BOOL) Se o fluxo de trabalho usa etapas paralelas.
compute_step_count GA  (projeto)
Contagem de etapas de computação
DELTA, INT64, 1
workflows.googleapis.com/Workflow 		Número de etapas de computação executadas (por exemplo, etapas "assign" e "for"). Amostras coletadas a cada 60 segundos. Após a amostragem, os dados não são visíveis por até 120 segundos.
revision_id: O ID da revisão do fluxo de trabalho executado.
compute_step_latencies GA  (projeto)
Latências da etapa de computação
DELTA, DISTRIBUTION, ms
workflows.googleapis.com/Workflow 		Latências das etapas de computação executadas. Amostras coletadas a cada 60 segundos. Após a amostragem, os dados não são visíveis por até 120 segundos.
revision_id: O ID da revisão do fluxo de trabalho executado.
create_callback_step_count GA  (projeto)
Contagem de etapas de retorno de chamada de criação
DELTA, INT64, 1
workflows.googleapis.com/Workflow 		Número de etapas executadas que criam um callback. Amostras coletadas a cada 60 segundos. Após a amostragem, os dados não são visíveis por até 120 segundos.
revision_id: O ID da revisão do fluxo de trabalho executado.
method: O tipo de método do callback criado, como "POST".
deployment_attempt_count GA  (projeto)
Contagem de tentativas de implantação
DELTA, INT64, 1
workflows.googleapis.com/Workflow 		Número de tentativas de implantação de fluxo de trabalho. Amostras coletadas a cada 60 segundos. Após a amostragem, os dados não são visíveis por até 120 segundos.
revision_id: O ID da revisão do fluxo de trabalho executado.
result: O status das tentativas de implantação.
deployment_latencies GA  (projeto)
Latências de implantação
DELTA, DISTRIBUTION, ms
workflows.googleapis.com/Workflow 		Latências das tentativas de implantação do fluxo de trabalho. Amostras coletadas a cada 60 segundos. Após a amostragem, os dados não são visíveis por até 120 segundos.
revision_id: O ID da 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. Amostras coletadas a cada 60 segundos. Após a amostragem, os dados não são visíveis por até 120 segundos.
revision_id: O ID da revisão do fluxo de trabalho executado.
event_type: O tipo do evento.
event_time_to_ack_latencies GA  (projeto)
Latências de tempo do evento até o reconhecimento
DELTA, DISTRIBUTION, ms
workflows.googleapis.com/Workflow 		Latências desde o início de um evento até o momento em que o serviço de fluxos de trabalho o confirma. Amostras coletadas a cada 60 segundos. Após a amostragem, os dados não são visíveis por até 120 segundos.
revision_id: O ID da revisão do fluxo de trabalho executado.
event_type: O tipo do evento.
event_trigger_count GA  (projeto)
Contagem de acionadores de eventos
DELTA, INT64, 1
workflows.googleapis.com/Workflow 		Número de acionadores de eventos recebidos. Amostras coletadas a cada 60 segundos. Após a amostragem, os dados não são visíveis por até 120 segundos.
revision_id: O ID da revisão do fluxo de trabalho executado.
event_type: O tipo do evento.
result: O resultado do gatilho de evento.
execution_backlog_size GA  (projeto)
Tamanho do backlog de execução
GAUGE, INT64, 1
workflows.googleapis.com/Workflow 		Número de execuções que ainda não foram iniciadas. Amostras coletadas a cada 60 segundos. Após a amostragem, os dados não são visíveis por até 120 segundos.
revision_id: O ID da revisão do fluxo de trabalho executado.
execution_times BETA  (projeto)
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 da revisão do fluxo de trabalho executado.
external_step_count BETA  (projeto)
Contagem de etapas externas
DELTA, INT64, 1
workflows.googleapis.com/Workflow 		Contagem de etapas externas executadas para o fluxo de trabalho.
finished_execution_count BETA  (projeto)
Contagem de execuções concluídas
DELTA, INT64, 1
workflows.googleapis.com/Workflow 		Contagem de execuções concluídas do fluxo de trabalho.
status: O status de execução do fluxo de trabalho.
revision_id: O ID da revisão do fluxo de trabalho executado.
internal_execution_error_count GA  (projeto)
Contagem de erros de execução interna
DELTA, INT64, 1
workflows.googleapis.com/Workflow 		Número de execuções que falharam com um erro interno. Amostras coletadas a cada 60 segundos. Após a amostragem, os dados não são visíveis por até 120 segundos.
revision_id: O ID da revisão do fluxo de trabalho executado.
internal_step_count BETA  (projeto)
Contagem de etapas internas
DELTA, INT64, 1
workflows.googleapis.com/Workflow 		Contagem de etapas internas executadas para o fluxo de trabalho.
io_internal_request_count GA  (projeto)
Contagem de solicitações internas de E/S
DELTA, INT64, 1
workflows.googleapis.com/Workflow 		Número de solicitações de E/S feitas por um fluxo de trabalho aos serviços do Google. Amostras coletadas a cada 60 segundos. Após a amostragem, os dados não são visíveis por até 120 segundos.
revision_id: O ID da revisão do fluxo de trabalho executado.
service_domain: O domínio do serviço do Google que está sendo chamado, como "bigquery.googleapis.com".
io_step_count GA  (projeto)
Contagem de etapas de E/S
DELTA, INT64, 1
workflows.googleapis.com/Workflow 		Número de etapas de E/S executadas. Amostras coletadas a cada 60 segundos. Após a amostragem, os dados não são visíveis por até 120 segundos.
revision_id: O ID da revisão do fluxo de trabalho executado.
io_result: O resultado da etapa de E/S.
io_step_type: O tipo de etapa de E/S.
destination_type: O tipo de destino da etapa de E/S.
had_system_error: (BOOL) Se a etapa de E/S teve um erro de sistema.
io_step_latencies GA  (projeto)
Latências de etapa de E/S
DELTA, DISTRIBUTION, ms
workflows.googleapis.com/Workflow 		Latências das etapas de E/S executadas. Amostras coletadas a cada 60 segundos. Após a amostragem, os dados não são visíveis por até 120 segundos.
revision_id: O ID da revisão do fluxo de trabalho executado.
io_result: O resultado da etapa de E/S.
io_step_type: O tipo de etapa de E/S.
had_system_error: (BOOL) Se a etapa de E/S teve um erro de sistema.
kms_decrypt_latencies GA  (projeto)
Latências de descriptografia do KMS
DELTA, DISTRIBUTION, ms
workflows.googleapis.com/Workflow 		Latências de solicitações de descriptografia para o KMS por fluxos de trabalho para CMEK. Amostras coletadas a cada 60 segundos. Após a amostragem, os dados não são visíveis por até 120 segundos.
revision_id: O ID da revisão do fluxo de trabalho executado.
status: O status das solicitações de descriptografia.
attempts: (INT64) A contagem de tentativas das solicitações de descriptografia.
kms_decrypt_request_count GA  (projeto)
Contagem de solicitações de descriptografia do KMS
DELTA, INT64, 1
workflows.googleapis.com/Workflow 		Número de solicitações de descriptografia do KMS feitas pelo serviço para a CMEK. Amostras coletadas a cada 60 segundos. Após a amostragem, os dados não são visíveis por até 120 segundos.
revision_id: O ID da revisão do fluxo de trabalho executado.
status: O status das solicitações de descriptografia.
kms_encrypt_latencies GA  (projeto)
Latências de criptografia do KMS
DELTA, DISTRIBUTION, ms
workflows.googleapis.com/Workflow 		Latências de solicitações de criptografia para o KMS por fluxos de trabalho para CMEK. Amostras coletadas a cada 60 segundos. Após a amostragem, os dados não são visíveis por até 120 segundos.
revision_id: O ID da revisão do fluxo de trabalho executado.
status: O status das solicitações de criptografia.
attempts: (INT64) A contagem de tentativas das solicitações de criptografia.
kms_encrypt_request_count GA  (projeto)
Contagem de solicitações de criptografia do KMS
DELTA, INT64, 1
workflows.googleapis.com/Workflow 		Número de solicitações de criptografia do KMS feitas pelo serviço para CMEK. Amostras coletadas a cada 60 segundos. Após a amostragem, os dados não são visíveis por até 120 segundos.
revision_id: O ID da revisão do fluxo de trabalho executado.
status: O status das solicitações de criptografia.
parallel_branch_step_count GA  (projeto)
Contagem de etapas de ramificação paralela
DELTA, INT64, 1
workflows.googleapis.com/Workflow 		Número de etapas executadas usando ramificações paralelas. Amostras coletadas a cada 60 segundos. Após a amostragem, os dados não são visíveis por até 120 segundos.
revision_id: O ID da revisão do fluxo de trabalho executado.
parallel_branch_substep_count GA  (projeto)
Contagem de subetapas de ramificação paralela
DELTA, INT64, 1
workflows.googleapis.com/Workflow 		Número de etapas executadas em ramificações paralelas. Amostras coletadas a cada 60 segundos. Após a amostragem, os dados não são visíveis por até 120 segundos.
revision_id: O ID da revisão do fluxo de trabalho executado.
parallel_iteration_step_count GA  (projeto)
Contagem de etapas de iteração paralela
DELTA, INT64, 1
workflows.googleapis.com/Workflow 		Número de etapas executadas usando iterações paralelas. Amostras coletadas a cada 60 segundos. Após a amostragem, os dados não são visíveis por até 120 segundos.
revision_id: O ID da revisão do fluxo de trabalho executado.
parallel_iteration_substep_count GA  (projeto)
Contagem de subetapas de iteração paralela
DELTA, INT64, 1
workflows.googleapis.com/Workflow 		Número de etapas executadas em iterações paralelas. Amostras coletadas a cada 60 segundos. Após a amostragem, os dados não são visíveis por até 120 segundos.
revision_id: O ID da revisão do fluxo de trabalho executado.
parallel_unhandled_exceptions_limit_count GA  (projeto)
Contagem de limite de exceções paralelas não processadas
DELTA, INT64, 1
workflows.googleapis.com/Workflow 		Número de vezes que o limite de exceção paralela não processada foi atingido. Amostras coletadas a cada 60 segundos. Após a amostragem, os dados não são visíveis por até 120 segundos.
revision_id: O ID da revisão do fluxo de trabalho executado.
pending_io_requests GA  (projeto)
Solicitações de E/S pendentes
GAUGE, INT64, 1
workflows.googleapis.com/Workflow 		Número de solicitações de E/S em andamento. Amostras coletadas a cada 60 segundos. Após a amostragem, os dados não são visíveis por até 120 segundos.
revision_id: O ID da revisão do fluxo de trabalho executado.
sent_bytes_count BETA  (projeto)
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 da revisão do fluxo de trabalho executado.
started_execution_count BETA  (projeto)
Contagem de execuções iniciadas
DELTA, INT64, 1
workflows.googleapis.com/Workflow 		Contagem de execuções iniciadas para o fluxo de trabalho.
revision_id: O ID da revisão do fluxo de trabalho executado.
started_vpcsc_executions_count GA  (projeto)
Contagem de execuções iniciadas do VPC-SC
DELTA, INT64, 1
workflows.googleapis.com/Workflow 		Número de execuções restritas do VPC-SC iniciadas. Amostras coletadas a cada 60 segundos. Após a amostragem, os dados não são visíveis por até 120 segundos.
revision_id: O ID da revisão do fluxo de trabalho executado.
vpcsc_protected_io_count GA  (projeto)
Contagem de E/S protegidas pelo VPC-SC
DELTA, INT64, 1
workflows.googleapis.com/Workflow 		Número de solicitações de E/S feitas usando o VPC-SC. Amostras coletadas a cada 60 segundos. Após a amostragem, os dados não são visíveis por até 120 segundos.
revision_id: O ID da revisão do fluxo de trabalho executado.

Tabela gerada em 08-08-2025 23:40:45 UTC.

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.Também é possível testar o método timeSeries.list usando o APIs Explorer baseado em formulários. 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.

Monitorar métricas de cota

O exemplo a seguir demonstra como usar o APIs Explorer para consultar a cota total de alocação consumida para o Workflows. Especificamente, ele usa a métrica serviceruntime.googleapis.com/quota/allocation/usage no tipo de recurso Consumer Quota. É possível definir outros filtros de rótulo (service, quota_metric) para especificar o tipo de cota. Para mais informações sobre como monitorar métricas de cota, incluindo outros exemplos e como criar políticas de alertas, consulte Criar gráficos e monitorar métricas de cota.

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

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

  3. No campo name, insira o ID do projeto Google Cloud usando o seguinte formato:

    projects/PROJECT_ID

  4. No campo filtro, especifique um único tipo de métrica e, opcionalmente, rótulos de métrica e outras informações. Exemplo:

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

  5. No campo interval.endTime, insira um horário de término para limitar a quantidade de dados retornados, que é aplicável ao seu uso. Ele precisa ser formatado como uma string RFC 3339. Por exemplo, 2024-11-07T03:01:02Z.

  6. No campo interval.startTime, insira um horário de início para limitar a quantidade de dados retornados, que é aplicável ao seu uso. Ele precisa ser formatado como uma string RFC 3339, por exemplo, 2024-11-07T03:01:00Z.

  7. Clique em Executar.

    O resultado será semelhante a este, com 350 indicando a métrica de cota 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 recolhido do APIs Explorer, clique em Tela cheia para expandir o APIs Explorer. O painel em tela cheia mostra um painel extra com exemplos de código, respostas application/json e respostas HTTP brutas. Por exemplo, neste caso, você pode conferir 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

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 Workflows.

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

A seguir