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 de fluxos 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 estes registos de auditoria 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

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

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 das APIs Explorer baseadas 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 consumida total 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 APIs Explorer reduzido, pode clicar em Ecrã inteiro para expandir o APIs Explorer. 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 do Monitoring 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?