Journaux personnalisés
Les journaux personnalisés sont des journaux qui contiennent des informations de diagnostic issues d'applications personnalisées, d'autres fournisseurs cloud ou d'un environnement sur site.
-
En utilisant PutLogs pour inclure directement les journaux personnalisés. Pour plus d'informations, reportez-vous à API d'inclusion de journalisation et API REST. Reportez-vous également à Inclusion de journaux personnalisés pour obtenir un exemple de charge utile d'entrée de journal pouvant être utilisées avec PutLogs.
-
En configurant l'agent de surveillance unifié. Pour obtenir des instructions, reportez-vous à Installation de l'agent.
Remarque
Lors de la gestion des modules d'extension de l'agent Oracle Cloud, l'agent de surveillance unifié procède à la surveillance des journaux personnalisés.
Les journaux personnalisés peuvent être affichés sur la page d'instance Oracle Cloud Infrastructure Compute et sont associés à une ressource Journaux. Ils peuvent également être affichés sur la page de recherche du service Logging, sur la page Journaux ou sur la page de détails Groupes de journaux associée. Les journaux personnalisés sont également pris en charge dans les instances Bare Metal.
Vous pouvez également visualiser le taux d'acceptation et d'inclusion des journaux personnalisés à l'aide du service Oracle Cloud Infrastructure Monitoring. Pour plus d'informations, reportez-vous à Affichage du taux d'acceptation des journaux personnalisés.
L'agent de surveillance unifié peut être installé sur de nombreuses machines et il extrait les journaux des répertoires locaux, où vos applications ou systèmes émettent des journaux. L'agent peut également analyser vos journaux pour vous. Tous ces paramètres sont configurés dans Configurations d'agent. Vous pouvez créer une configuration d'agent séparément, puis lui associer un journal personnalisé, ou créer un journal personnalisé, puis créer ultérieurement la configuration d'agent correspondante.
- les hôtes dont vous souhaitez collecter des journaux ;
- les journaux spécifiques que vous souhaitez obtenir de la part des hôtes ;
- des analyseurs supplémentaires ;
- la destination du journal personnalisé.
La création d'un journal personnalisé s'effectue en deux étapes : vous devez d'abord créer l'objet de journal personnalisé, puis la configuration d'agent correspondante. Reportez-vous à Création d'un journal pour plus d'informations sur la création de journaux personnalisés et de configurations d'agent, et à Présentation de la gestion de l'agent pour plus d'informations sur la configuration et la gestion de l'agent.
Pour que l'agent soit exécuté correctement, assurez-vous que les paramètres de pare-feu autorisent les adresses d'URI suivantes :
- https://auth.<votre région>.oraclecloud.com
- https://ingestion.logging.<votre région>.oci.oraclecloud.com.
Métadonnées de journal personnalisées et charge de stockage
Les métadonnées de journal personnalisées sont ajoutées lors de l'assimilation à deux emplacements afin d'optimiser les coûts de stockage :
- Au niveau request
- Au niveau de la ligne de journal
Une demande est un ensemble de lignes de journal, et la demande peut y inclure une ou plusieurs lignes de journal. Ces demandes peuvent inclure un lot de lignes de journal qui ont été incluses, puis des appels ultérieurs à l'inclusion de lignes de journal supplémentaires peuvent se produire. Une demande peut également comporter un nombre différent de lignes de journal, selon la manière dont les clients envoient les données. Les clients ne sont facturés qu'une seule fois pour les métadonnées au niveau de la demande. Lorsque des lignes de journal supplémentaires dans une demande sont incluses, aucun frais supplémentaire n'est engagé à ce niveau. Les métadonnées de demande s'appliquent à toutes les lignes de journal d'une demande au niveau de la demande, au lieu d'ajouter des métadonnées supplémentaires à chaque ligne de journal, ce qui permet d'économiser sur les coûts de stockage.
Voici un exemple de métadonnées de niveau demande :
{
"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>"
}La taille minimale des métadonnées de demande est de 500 octets, mais la quantité peut varier en fonction de la taille des données client dans les champs source, subject et type. La taille totale des métadonnées peut varier en fonction des données spécifiques du client dans ces champs.
Au niveau de la ligne de journal, qui contient la charge utile de journal réelle, les métadonnées de 100 octets suivantes sont ajoutées pour chaque ligne de journal :
{
"data":{
<log payload>
},
"id":"fb1f6b06-4ed5-4133-a1d0-ad2ffc3addc6",
"time":"2022-05-23T11:54:30.532Z",
}Les éléments id et time sont obligatoires et indiquent l'événement de journal correspondant, ainsi que l'heure de création.
source, subject et type), si l'agent de surveillance unifié Oracle Cloud Infrastructure Logging a reçu une demande avec 100 lignes de journal, chaque ligne de journal ayant une taille de 1 ko, la taille totale des métadonnées ajoutées est d'environ 10,5 ko pour le calcul suivant :- Niveau de demande : 500 octets
- Niveau de ligne de journal : 100 (nombre de lignes de journal dans une demande) * 100 octets (métadonnées de chaque ligne de journal) = 10 ko
La quantité totale de lignes de journal envoyées dans cet exemple de demande est de 100 * 1 ko = 100 ko. Après l'ajout des métadonnées, la taille de stockage des journaux obtenue est de 110,5 ko.