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 usted como los usuarios de sus servicios administrados pueden usar Google Cloud Console 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 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: Un recurso supervisado representa una entidad de nube que produce algunos datos de registro. Para definir un recurso supervisado en la configuración del servicio, consulta monitored_resource.proto para la especificación técnica. Te recomendamos que uses el mismo recurso supervisado para la supervisión 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 para obtener la especificación técnica.

En el siguiente ejemplo de configuración de servicio, el registro activity_log se configura 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 Control de servicios 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 Control de servicios.

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