Monitorar fluxos de trabalho

O Google Cloud Observability oferece ferramentas de monitoramento, geração de registros e diagnóstico. Essas ferramentas podem ajudar a monitorar e analisar implantações e execuções de fluxos de trabalho e entender o comportamento, a integridade e o desempenho 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.
  • Enviar métricas do sistema e dos 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 bem grandes. Para mais informações, consulte Ativar os registros de auditoria de acesso a dados.

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

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 a Observability do Google Cloud. Um recurso monitorado no monitoramento 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 acessados, informadas em um painel ou usadas para criar alertas. Cada recurso também tem um conjunto de rótulos de recursos, 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.

Para conferir todos os tipos de recursos, consulte Tipos de recursos monitorados. Para conferir todos os tipos de métricas, consulte Métricas do Google Cloud. Abra o seguinte para conferir uma lista dos tipos de métricas enviadas dos Workflows para o Google Cloud Observability:

Tipos de métricas 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 espera de callback
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 callback
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 fatias de computação
DELTA, INT64, 1
workflows.googleapis.com/Workflow 		Número de fatias de computação executadas. As etapas são executadas em fatias de trabalho, o que depende do tipo de etapa que está sendo executada. 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 fatia de computação, como "IO_REQUEST" ou "WAKEUP".
has_parallel: (BOOL) Indica se o fluxo de trabalho usa etapas paralelas.
compute_slice_latencies GA  (projeto)
Latências de fatia de computação
DELTA, DISTRIBUTION, ms
workflows.googleapis.com/Workflow 		Latências desde o momento em que uma fatia 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 fatia de computação, como "IO_REQUEST" ou "WAKEUP".
has_parallel: (BOOL) Indica 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 de etapas 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)
Criar contagem de etapas de callback
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 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.
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 de 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 gatilhos de evento 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 para confirmação de recebimento de eventos
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 do 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 para os 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 do 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 do 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 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ência 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 o 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 filiais 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 ramos paralelos. 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 subpassos 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 não tratadas em paralelo
DELTA, INT64, 1
workflows.googleapis.com/Workflow 		Número de vezes que o limite de exceções paralelas não tratadas 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 de 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 do 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 26-11-2024 17:39:42 UTC.

Ler dados de métricas

É possível ler dados de métrica, 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 criando um gráfico com o Metrics Explorer.Também é possível testar o método timeSeries.list usando o APIs Explorer com base 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 seus dados de métricas, consulte Extrair dados de séries temporais.

Monitorar métricas de cota

O exemplo a seguir demonstra como usar o APIs Explorer para consultar a cota de alocação total consumida para 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 mais exemplos e como criar políticas de alertas, consulte Gráfico e monitoramento de métricas de cota.

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

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

  3. No campo name, insira o ID do projeto do 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 e que sejam aplicáveis 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 e que seja 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 ao seguinte, 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 do APIs Explorer recolhido, clique em Tela cheia para expandir o APIs Explorer. O painel de tela cheia mostra um painel extra com exemplos de código, respostas application/json e respostas HTTP brutas. Por exemplo, neste caso, é possível 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 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