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 registro estructurados o no estructurados, que agrupa en lotes y reenvía a Cloud Logging. Tanto tú como los usuarios de tus servicios administrados pueden usar la consola de Google Cloud y la Consola de API de Google para ver los datos de registro o usar la API de Cloud 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 Service Control 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 Service Control, 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: Un recurso supervisado representa una entidad de la nube que produce algunos datos de registro. Para definir un recurso supervisado en la configuración del servicio, consulta monitored_resource.proto a fin de obtener la especificación técnica. Te recomendamos que uses el mismo recurso supervisado para la monitoring y el registro.

  • 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. Para configurar la asociación de registros, consulta logging.proto a fin de ver la especificación técnica.

En el siguiente ejemplo de configuración de servicio, el registro activity_log está configurado para enviarse al consumidor de servicios.

# The definition of the monitored resource to be used.
monitored_resources:
- type: library.appspot.com/Branch
  description: A library branch
  display_name: Library Branch
  launch_stage: ALPHA
  labels:
  - key: resource_container
    description: The Google Cloud resource container (ie. project id) for
    the branch.
  - key: location
    description: The Google Cloud region the branch is located.
  - key: branch_id
    description: The ID of the branch.

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

# The logging configuration.
logging:
  consumer_destinations:
  - monitored_resource: library.appspot.com/Branch
    logs:
    - activity_log

Una vez que hayas creado esa configuración, deberás seguir las instrucciones sobre cómo administrar configuraciones de servicio y administrar lanzamientos de servicios para enviar la configuración del servicio a la API de Administración de Servicios , que configurará el recurso supervisado en Cloud Logging.

Informa registros

Una vez que finaliza el envío de la configuración de servicio, puedes llamar a la API de Service Control para informar las entradas de registro. El siguiente ejemplo utiliza el comando de gcurl para demostrar la llamada. Para obtener información sobre cómo realizar la configuración, consulta Comienza a usar la API de Service Control.

gcurl -d "{
  'operations': [ {
    'operationId': 'e8bf36ef-f9b5-4274-b4f9-079a3731e6e5',
    'operationName': 'New book arrived',
    'consumerId': 'projects/library-consumer',
    'startTime': '`date +%FT%T%:z`',
    'endTime': '`date +%FT%T%:z`',
    'labels': {
      'location': 'us-east1',
      'branch_id': 'my-test-library-branch'
    },
    'logEntries': [ {
      'severity': 'INFO',
      'textPayload': 'new book arrived',
      'name': 'activity_log'
    } ]
  } ]
}" https://servicecontrol.googleapis.com/v1/services/endpointsapis.appspot.com:report