Informa las métricas de supervisión

En esta página, se describe cómo usar Service Infrastructure para habilitar servicios administrados a fin de generar datos de supervisión para enviar a los proyectos del productor de servicios y del consumidor de servicios. Monitoring proporciona visibilidad del rendimiento, el tiempo de actividad y el estado general de los servicios administrados individuales.

La API de Control de Servicios acepta métricas, que organiza en lotes, agrega y reenvía a Stackdriver Monitoring. Monitoring transfiere estas métricas y genera estadísticas mediante paneles, gráficos y alertas.

Mientras que Monitoring por sí solo permite que un servicio administrado genere datos de supervisión para que los utilices como desarrollador del servicio administrado, la API de Control de Servicios también te permite generar datos de supervisión que están destinados a tus usuarios. Esto permite que los usuarios entiendan y diagnostiquen el uso de tu servicio administrado.

Configura la supervisión

Antes de enviar datos de supervisión a la API de Control de servicios, debes especificar tres bits diferentes de información en la configuración de servicio:

  • Recursos supervisados: Un recurso supervisado representa una entidad de la nube que origina algunos datos de supervisión o que está sujeta a ellos. Stackdriver Monitoring proporciona un conjunto conocido de tipos de recursos supervisados desde el que puedes elegir.

  • Métricas: Puedes enviar una o más métricas. Cada métrica representa un fragmento de estado cuyo valor se rastrea en el tiempo. Stackdriver Monitoring proporciona un conjunto conocido de métricas desde el que puedes elegir.

  • Configuración de la supervisión: Te permite especificar las métricas asociadas con los recursos supervisores individuales y el proyecto del productor de servicios o el consumidor de servicios donde se debe enviar cada registro.

En el siguiente ejemplo del estado de configuración de servicio se define un recurso supervisado y una métrica. Un cliente puede invocar el método services.report para informar valores en la métrica. Consulta monitoring.proto para obtener información sobre la configuración de servicios.

# 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

Informa las métricas

Una vez que hayas definido la supervisión en la configuración de servicio y la envíes a la API de Service Management, puedes llamar a la API de Control de servicios para informar las métricas. En el siguiente ejemplo se utiliza el comando gcurl para demostrar la llamada. Para obtener información sobre cómo realizar la configuración, consulta Comienza a usar la API de Control de servicios.

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
¿Te sirvió esta página? Envíanos tu opinión:

Enviar comentarios sobre…

Service Infrastructure