Como gerar relatórios de métricas de monitoramento

Nesta página, você aprende a usar o Service Infrastructure a fim de permitir que os serviços gerenciados gerem dados de monitoramento a serem enviados para projetos de produtor e consumidor de serviço. O Monitoring permite ver informações sobre desempenho, tempo de atividade e integridade geral de serviços gerenciados individuais.

A API Service Control aceita métricas, que são agrupadas, agregadas e encaminhadas ao Stackdriver Monitoring. O Monitoring ingere essas métricas e gera insights por meio de painéis, gráficos e alertas.

Assim como o Monitoring permite que um serviço gerenciado gere dados de monitoramento para uso por você como desenvolvedor do serviço gerenciado, a API Service Control também permite gerar dados de monitoramento destinados a seus usuários. Isso possibilita que seus usuários entendam e diagnostiquem o uso do seu serviço gerenciado.

Como configurar o monitoramento

Antes de enviar dados de monitoramento para a API Service Control, você precisa especificar três informações diferentes na sua configuração de serviço:

  • Recursos monitorados: um recurso monitorado representa uma entidade de nuvem que origina alguns dados de monitoramento ou está sujeita a eles. O Stackdriver Monitoring oferece um grupo conhecido de tipos de recursos monitorados para seleção.

  • Métricas: você pode relatar uma ou mais métricas. Cada métrica representa um estado cujo valor é rastreado ao longo do tempo. O Stackdriver Monitoring oferece um grupo conhecido de métricas para seleção.

  • Configuração de monitoramento: permite especificar as métricas associadas a recursos monitorados individuais e o projeto de produtor ou consumidor de serviço em que cada registro será enviado.

O exemplo a seguir do estado de configuração de serviço define um recurso monitorado e uma métrica. Um cliente pode invocar o método services.report para relatar valores da métrica. Consulte monitoring.proto para mais detalhes sobre a configuração de serviço.

# The monitored resource to be used.
monitored_resources:
- type: api
  labels:
  - key: cloud.googleapis.com/location
  - key: serviceruntime.googleapis.com/api_version
  - key: serviceruntime.googleapis.com/api_method
  - key: cloud.googleapis.com/project
  - key: cloud.googleapis.com/service
  - key: cloud.googleapis.com/uid

# The metrics to be used.
metrics:
- name: serviceruntime.googleapis.com/api/consumer/request_count
  metric_kind: DELTA
  value_type: INT64

# The monitoring configuration.
monitoring:
  producer_destinations:
  - monitored_resource: api
    metrics:
    - serviceruntime.googleapis.com/api/consumer/request_count
  consumer_destinations:
  - monitored_resource: api
    metrics:
    - serviceruntime.googleapis.com/api/consumer/request_count

Como relatar métricas

Depois de configurar o monitoramento na configuração de serviço e enviar a configuração por push à API Service Management, você pode chamar a API Service Control para relatar métricas. No exemplo a seguir, o comando gcurl é usado para demonstrar a chamada. Para informações sobre como fazer a configuração, consulte Primeiros passos com a API Service Control.

gcurl -d "{
  'operations': [ {
    'operationId': '8356d3c5-f9b5-4274-b4f9-079a3731e6e5',
    'operationName': 'google.example.hello.v1.HelloService.GetHello',
    'consumerId': 'project:endpointsapis-consumer',
    'startTime': '`date +%FT%T%:z`',
    'endTime': '`date +%FT%T%:z`',
    'labels': {
      'cloud.googleapis.com/location': 'global',
      'serviceruntime.googleapis.com/api_version': 'v1',
      'serviceruntime.googleapis.com/api_method': 'google.example.hello.v1.HelloService.GetHello',
      'cloud.googleapis.com/project': 'proven-catcher-789',
      'cloud.googleapis.com/service': 'endpointsapis.appspot.com',
      'cloud.googleapis.com/uid': '92830528305210394'
    },
    'metricValueSets': [ {
      'metricName': 'serviceruntime.googleapis.com/api/consumer/request_count',
      'metricValues': [ { 'int64Value': '23' } ]
    } ]
  } ]
}" https://servicecontrol.googleapis.com/v1/services/endpointsapis.appspot.com:report
Esta página foi útil? Conte sua opinião sobre:

Enviar comentários sobre…

Documentação do Service Infrastructure