Documentation sur Oracle Cloud Infrastructure

Journaux personnalisés

Les journaux personnalisés sont des journaux qui contiennent des informations de diagnostic provenant d'applications personnalisées, d'autres fournisseurs de services en nuage ou d'un environnement sur place.

Ils peuvent être ingérés comme suit :

Vous pouvez consulter les journaux personnalisés dans la page de l'instance du service Calcul pour Oracle Cloud Infrastructure et associer une ressource Journaux. Vous pouvez également les consulter dans la page Rechercher du service de journalisation, dans la page Journaux ou dans une page de détails Groupes de journaux associée. Les journaux personnalisés sont également pris en charge dans les instances sans système d'exploitation.

Note

Vous pouvez également voir le taux d'acceptation et d'ingestion des journaux personnalisés à l'aide du service Oracle Cloud Infrastructure Monitoring. Pour plus d'informations, voir Affichage du taux d'acceptation des journaux personnalisés.

L'agent unifié de surveillance peut être installé sur de nombreuses machines et il extrait les journaux des répertoires locaux, où les applications ou les systèmes émettent des journaux. L'agent peut également analyser les journaux pour vous. Tout cela est configuré dans les 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 sa configuration d'agent.

Une configuration d'agent est le mécanisme central pour définir :
  • Les hôtes de provenance des journaux.
  • Les journaux spécifiques que vous voulez obtenir des hôtes.
  • Des analyseurs supplémentaires.
  • La destination du journal personnalisé.

La création d'un journal personnalisé est un processus en deux étapes, dans lequel vous créez d'abord l'objet de journal personnalisé, puis la configuration d'agent associée. Voir Création d'un journal pour plus d'informations sur la création de journaux personnalisés et les configurations d'agent, et Aperçu de la gestion de l'agent pour plus d'informations sur la configuration et la gestion de l'agent.

Note

Pour que l'agent s'exécute correctement, assurez-vous que les paramètres du pare-feu permettent les points d'extrémité d'URI suivants :
  • https://auth.<votre région>.oraclecloud.com
  • https://ingestion.logging.<votre région>.oci.oraclecloud.com.

Métadonnées de journal personnalisées et chargement du stockage

Les métadonnées de journal personnalisées sont ajoutées lors de l'ingestion à deux endroits pour optimiser les coûts de stockage :

  • Au niveau de la demande
  • Au niveau de la ligne de journal

Une demande est une collection de lignes de journal, dans laquelle la demande peut inclure une ou plusieurs lignes de journal. Ces demandes peuvent inclure un lot de lignes de journal qui ont été ingérées, puis des appels ultérieurs d'ingestion de lignes de journal supplémentaires peuvent se produire. Une demande peut également avoir un nombre différent de lignes de journal, selon la façon dont les clients envoient des données. Les clients ne sont facturés qu'une seule fois pour les métadonnées au niveau de la demande. Comme les lignes de journal supplémentaires d'une demande sont ingérées, aucuns frais supplémentaires ne sont engagés à 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 des exemples de métadonnées au niveau de la 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 le montant peut varier en fonction de la taille des données du client dans les champs source, subject et type. La taille totale des métadonnées peut varier en fonction des données particulières du client dans ces champs.

Au niveau de la ligne de journal, qui contient les données utiles réelles du journal, les métadonnées 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 valeurs id et time sont obligatoires, et indiquent l'événement de journal correspondant, ainsi que l'heure de création.

Par exemple (en supposant des données vides dans les champs source, subject et type), si l'agent de surveillance unifiée d'Oracle Cloud Infrastructure Logging a reçu une demande avec 100 lignes de journal, où chaque ligne de journal était de 1 Ko, la taille totale des métadonnées ajoutées est d'environ 10,5 Ko par 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

Le nombre total 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 résultante est de 110,5 Ko.