Eventos y métricas de DDFS

Revisar tipos de eventos de servicio de eventos, cobertura de auditoría y métricas de supervisión para el servicio FHIR de datos de dispositivo (DDFS).

Puede utilizar métricas, alarmas, notificaciones y reglas de Events para supervisar instancias de DDFS y enrutar eventos de ciclo de vida a servicios de OCI descendentes.

DDFS emite eventos del servicio Events para operaciones de ciclo de vida de instancias. DDFS también emite eventos de auditoría para operaciones del plano de control de lectura y mutación, de modo que los administradores puedan revisar quién invocó una operación, qué recurso se vio afectado y si la operación se completó correctamente.

Recurso: recursos de instancia de DDFS.

Requisitos

Para supervisar o enrutar eventos de DDFS, debe tener permiso para ver los recursos de DDFS y para crear o gestionar reglas de eventos en el compartimento de destino. Para revisar los gráficos de supervisión o los registros de auditoría relacionados, también debe tener permisos para leer métricas y logs de auditoría para el compartimento que contiene la instancia de DDFS.

Descripción general de eventos de DDFS

Las operaciones de ciclo de vida de DDFS son asíncronas cuando crean, actualizan, mueven o suprimen una instancia. Para estas operaciones, DDFS emite tipos de eventos de inicio y fin. Utilice el evento de inicio para detectar que la operación se ha aceptado y utilice el evento de finalización para detectar el resultado de la solicitud de trabajo de terminal.

Para eventos de servicio de eventos asíncronos, utilice data.eventGroupingId para correlacionar los eventos de inicio y finalización para la misma operación de ciclo de vida.

Tipos de eventos de DDFS

Los siguientes tipos de eventos de servicio de eventos están registrados para operaciones de ciclo de vida de DDFS. Utilice estos valores al crear reglas de eventos.

Nombre fácil de recordar Tipo de evento Operación Fase
Inicio de creación de instancia de DDFS com.oraclecloud.ddfs.createinstance.begin CreateInstance Inicio
Fin de creación de instancia de DDFS com.oraclecloud.ddfs.createinstance.end CreateInstance Finalizar
Inicio de actualización de instancia de DDFS com.oraclecloud.ddfs.updateinstance.begin UpdateInstance Inicio
Fin de actualización de instancia de DDFS com.oraclecloud.ddfs.updateinstance.end UpdateInstance Finalizar
Inicio de supresión de instancia de DDFS com.oraclecloud.ddfs.deleteinstance.begin DeleteInstance Inicio
Fin de supresión de instancia de DDFS com.oraclecloud.ddfs.deleteinstance.end DeleteInstance Finalizar
Inicio de movimiento de instancia de DDFS com.oraclecloud.ddfs.changeinstancecompartment.begin ChangeInstanceCompartment Inicio
Fin de movimiento de instancia de DDFS com.oraclecloud.ddfs.changeinstancecompartment.end ChangeInstanceCompartment Finalizar

Las reglas de eventos utilizan los valores de tipo de evento en minúscula de la tabla. Los registros de log de auditoría para las mismas operaciones pueden mostrar valores de tipo basados en operaciones, como com.oraclecloud.DDFS.CreateInstance.begin.

Cobertura de evento de auditoría

Las operaciones del plano de control DDFS se configuran para la emisión automática de eventos de auditoría. Los registros de auditoría están disponibles para operaciones de lectura síncrona y para operaciones de ciclo de vida asíncronas.

Operación Fase de evento de auditoría Notas
ListInstances Síncrono El evento de auditoría se emite para las solicitudes de lista.
GetInstance Síncrono El evento de auditoría se emite para las solicitudes get.
CreateInstance Iniciar y finalizar Los registros de inicio y fin asíncrono de auditoría se emiten para crear solicitudes de trabajo.
UpdateInstance Iniciar y finalizar Los registros de inicio y fin asíncrono de auditoría se emiten para las solicitudes de trabajo de actualización.
DeleteInstance Iniciar y finalizar Los registros de inicio y fin asíncrono de auditoría se emiten para eliminar solicitudes de trabajo.
ChangeInstanceCompartment Iniciar y finalizar Los registros de auditoría utilizan la semántica de movimiento e incluyen el contexto del compartimento de origen y destino cuando está disponible.

Detalles de carga útil de eventos y auditoría

Cargas útiles del servicio Events

Un evento de servicio Events contiene campos de sobre de CloudEvents como eventType, eventTime y source. Su objeto data contiene el contexto de recurso de DDFS, incluido el compartimento, el nombre de recurso y el OCID de recurso. Los eventos de ciclo de vida asíncronos incluyen data.eventGroupingId; utilice este campo para correlacionar los eventos de inicio y finalización para la misma operación.

Las cargas útiles del servicio Events no incluyen los objetos data.identity, data.request, data.response o data.stateChange específicos de la auditoría.

Cargas útiles de registro de auditoría

Un registro de auditoría incluye el nombre de la operación de API, la hora del evento, el origen, el compartimento, el nombre del recurso o el OCID del recurso, la identidad del emisor de llamada, los detalles de la solicitud y los detalles de la respuesta cuando los datos están disponibles. Para operaciones asíncronas, utilice data.eventGroupingId para enlazar los registros de auditoría de inicio y finalización para la misma operación. data.request.id identifica la solicitud de API representada por un registro de auditoría individual; no es el campo de correlación para los registros de inicio y finalización.

Un registro de auditoría de finalización asíncrona puede incluir data.response.payload con el tipo de operación de solicitud de trabajo, como CREATE_INSTANCE, UPDATE_INSTANCE, MOVE_INSTANCE o DELETE_INSTANCE, y el estado de la solicitud de trabajo de terminal. data.stateChange puede incluir el estado del ciclo de vida, el nombre mostrado, el compartimento y los cambios de etiqueta cuando esos detalles estén disponibles.

No incluya información de salud protegida, información de identificación personal, identificadores de recursos FHIR, identificadores de pacientes, identificadores de dispositivos ni identificadores de episodios clínicos en nombres de instancias, etiquetas, nombres de reglas de eventos o nombres de alarmas de DDFS.

Crear una regla de eventos para eventos de DDFS

Utilice las reglas de eventos para hacer coincidir los tipos de eventos de DDFS y entregar eventos coincidentes a una acción admitida.

Uso de la consola
  1. Abra el menú de navegación y seleccione Observability & Management. En Servicio de eventos, seleccione Reglas.
  2. Seleccione el compartimento que contiene los recursos de instancia de DDFS que desea supervisar.
  3. Cree una regla y agregue una condición que coincida con los eventos del servicio FHIR de datos de dispositivo o uno o más valores de tipo de evento de la tabla Tipos de eventos de DDFS.
  4. Seleccione la acción que recibe los eventos coincidentes, como un tema de notificaciones, una función de funciones o un flujo de flujo y, a continuación, guarde la regla.

Uso de la API

Utilice la API de eventos para crear reglas que coincidan con los tipos de eventos de DDFS. Utilice la API de control para alarmas y métricas al supervisar el comportamiento del servicio. Utilice Auditoría o Búsqueda de registro para revisar los registros de auditoría de las operaciones de lectura y las solicitudes de trabajo de ciclo de vida.

El siguiente fragmento de condición muestra los valores de tipo de evento que puede incluir en una regla Events.

{
  "eventType": [
    "com.oraclecloud.ddfs.createinstance.begin",
    "com.oraclecloud.ddfs.createinstance.end",
    "com.oraclecloud.ddfs.updateinstance.begin",
    "com.oraclecloud.ddfs.updateinstance.end",
    "com.oraclecloud.ddfs.deleteinstance.begin",
    "com.oraclecloud.ddfs.deleteinstance.end",
    "com.oraclecloud.ddfs.changeinstancecompartment.begin",
    "com.oraclecloud.ddfs.changeinstancecompartment.end"
  ]
}

Para ver los nombres de métricas, las unidades y las dimensiones, consulte Referencia de métricas del servicio FHIR de datos de dispositivos.