Informa registros

En esta página, se describe cómo usar Service Infrastructure para habilitar servicios administrados a fin de enviar registros a los proyectos del productor de servicios y del consumidor de servicios.

La API de Control de servicios acepta datos de registros estructurados o no estructurados, que procesa por lotes y reenvía a Stackdriver Logging. Tú y los usuarios de tus servicios administrados pueden usar Google Cloud Platform Console y Google API Console para ver los datos de registro o usar la API de Stackdriver Logging para acceder a los datos de manera programática.

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

Configura registros

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

  • Nombres de registro: Puedes tener uno o más registros distintos. Cada registro se identifica mediante un nombre único. Los registros individuales te permiten aislar tipos distintos de datos si esto facilita la visualización o el uso de los datos.

  • Recursos supervisados: Los tipos de recursos supervisados controlan la forma de los datos que se conservan dentro de un registro determinado. Logging proporciona un conjunto conocido de tipos de recursos supervisados desde el que puedes elegir.

  • Configuración de registro: Te permite especificar el recurso supervisado asociado con cualquier transmisión de registro 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, el registro activity_log se configura para enviarse al consumidor de servicios. Consulta service.proto para obtener información sobre la configuración de servicio.

# 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

# The log name to be used.
logs:
- name: activity_log

# The logging configuration.
logging:
  consumer_destinations:
  - monitored_resource: api
    logs:
    - activity_log

Informa registros

Una vez que hayas configurado los registros en la configuración de servicio y la hayas enviado con la API de Service Management, puedes llamar a la API de Control de servicios para informar las entradas de registro. 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': 'e8bf36ef-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'
    },
    'logEntries': [ {
      'severity': 'INFO',
      'textPayload': 'new book arrived',
      'name': 'activity_log'
    } ]
  } ]
}" 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