Logs personalizados
Los logs personalizados son logs que contienen información de diagnóstico de aplicaciones personalizadas, otros proveedores de nube o un entorno local.
-
Mediante PutLogs para ingerir logs personalizados directamente. Consulte API de ingesta de logs y API de REST para obtener más información. Consulte también Ingestión de logs personalizados para ver un ejemplo de carga útil de entrada de log que se puede utilizar con PutLogs.
-
Mediante la configuración de Unified Monitoring Agent. Consulte Instalación del agente para obtener instrucciones.
Nota
Al gestionar los plugins de Oracle Cloud Agent, Unified Monitoring Agent se denomina "Supervisión de logs personalizados".
Los logs personalizados se pueden ver en la página de instancia de Oracle Cloud Infrastructure Compute y tienen un recurso Logs asociado. También se pueden ver en la página Buscar de Logging, en la página Logs o en una página de detalle Grupos de log asociada. Los logs personalizados también están soportados en instancias con hardware dedicado.
También puede ver el ratio de aceptación e ingestión de logs personalizados mediante el servicio Oracle Cloud Infrastructure Monitoring. Consulte Visualización del ratio de aceptación de logs personalizados para obtener más información.
Unified Monitoring Agent se puede instalar en muchas máquinas y extrae logs de directorios locales, donde las aplicaciones o los sistemas emiten logs. El agente también puede analizar los logs en su lugar. Todo esto se configura en Configuraciones de agente. Puede crear una configuración de agente por separado y, a continuación, asociarle un log personalizado, o crear un log personalizado y, posteriormente, crear su configuración de agente.
- Los hosts de los que desea obtener los logs.
- Los logs específicos que desea obtener de los hosts.
- Los analizadores adicionales.
- El destino de log personalizado.
La creación de un log personalizado es un proceso de dos pasos, en el que primero se crea el objeto de log personalizado y, a continuación, se crea la configuración de agente asociada. Consulte Creación de un log para obtener más información sobre la creación de logs personalizados y configuraciones de agentes, y Visión general de Gestión de agentes para obtener más información sobre la configuración y la gestión del agente.
Para que el agente se ejecute correctamente, asegúrese de que la configuración del firewall permita los siguientes puntos finales de URI:
- https://auth.<su región>.oraclecloud.com
- https://ingestion.logging.<su región>.oci.oraclecloud.com.
Metadatos de log personalizados y carga de almacenamiento
Los metadatos de log personalizados se agregan durante la ingestión en dos lugares para optimizar los costos de almacenamiento:
- En el nivel request (solicitud)
- En el nivel de línea de registro.
Una solicitud es una recopilación de líneas de log y la solicitud puede incluir una o más líneas de log en ella. Estas solicitudes pueden incluir un lote de líneas de log que se ingirieron y, a continuación, se pueden producir llamadas posteriores para ingerir líneas de log adicionales. Una solicitud también puede tener una cantidad diferente de líneas de log, en función de cómo los clientes envían los datos. Los clientes solo se cargan una vez por los metadatos a nivel de solicitud. A medida que se ingieren líneas de log adicionales en una solicitud, no se incurre en cargos adicionales en este nivel. Los metadatos de solicitud se aplican a todas las líneas de log de una solicitud en el nivel de solicitud, en lugar de agregar metadatos adicionales a cada línea de log, lo que ayuda a ahorrar en costos de almacenamiento.
A continuación, se muestra un ejemplo de metadatos de nivel de solicitud:
{
"oracle":{
"compartmentid":"ocid1.compartment.oc1..<unique_id>",
"ingestedtime":"2022-05-23T18:00:04.073Z",
"loggroupid":"ocid1.loggroup.oc1.iad.<unique_id>",
"logid":"ocid1.log.oc1.iad.<unique_id>",
"tenantid":"ocid1.tenancy.oc1..<unique_id>"
},
"source":"<customer_data>",
"specversion":"1.0",
"subject":"<customer_data>",
"type":"<customer_data>"
}El tamaño mínimo de metadatos de solicitud es de 500 bytes, pero la cantidad puede variar según el tamaño de los datos del cliente en los campos source, subject y type. El tamaño total de los metadatos puede variar en función de los datos concretos del cliente en estos campos.
En el nivel de línea de log, que contiene la carga útil de log real, se agregan los siguientes metadatos de 100 bytes para cada línea de log:
{
"data":{
<log payload>
},
"id":"fb1f6b06-4ed5-4133-a1d0-ad2ffc3addc6",
"time":"2022-05-23T11:54:30.532Z",
}id y time son obligatorios e indican el evento de log correspondiente, junto con la hora de creación.
source, subject y type), si Oracle Cloud Infrastructure Logging Unified Monitoring Agent recibió una solicitud con 100 líneas de log, donde cada línea de log tenía un tamaño de 1 KB, el tamaño total de metadatos agregados es de alrededor de 10,5 KB por el siguiente cálculo:- Nivel de solicitud: 500 bytes
- Nivel de línea de log: 100 (número de líneas de log en una solicitud) * 100 bytes (cada uno de los metadatos de línea de log) = 10 KB
La cantidad total de líneas de log enviadas en este ejemplo de solicitud es 100 * 1 KB = 100 KB. Después de agregar los metadatos, el tamaño de almacenamiento de log resultante es de 110,5 KB.