Journaux

Vous pouvez intégrer le service de journalisation au service de science des données pour créer et gérer des journaux personnalisés.

Un journal personnalisé est une ressource OCI de première classe qui stocke et saisit les événements de journal collectés dans un contexte spécifique. Vous pouvez utiliser le service de journalisation pour activer, gérer et rechercher les journaux personnalisés du service Science des données pour ces ressources :

Note

Cette intégration est optionnelle pour toutes les ressources prises en charge.

Journaux des travaux

Vous pouvez intégrer des ressources de travaux au service Journalisation pour enregistrer les détails d'exécution de travail dans un journal personnalisé.

Les sorties standard (stdout) et d'erreur standard (stderr) de votre artefact de travail sont saisies et mises à disposition dans le journal personnalisé. Ces sorties ne sont pas disponibles pour le service de science des données. Nous vous recommandons vivement d'activer l'intégration de la journalisation pour les travaux, afin de déboguer les problèmes potentiels et de surveiller la progression de l'exécution des artefacts de travail.

Les messages sortants standard sont catégorisés sous le type "com.oraclecloud.datascience.jobrun.stdout", alors que les messages d'erreur standard le sont, sous le type "com.oraclecloud.datascience.jobrun.stderr". Pour les deux types, les métadonnées du journal incluent "source", qui est l'OCID de l'exécution de travail qui produit les messages.

Lorsque l'intégration de la journalisation est activée dans les configurations de journalisation des travaux, vous pouvez :

  • Indiquer vos propres groupe de journaux et journal pour saisir les sorties d'exécution de travail. Vous pouvez configurer toutes les exécutions de travail pour qu'elles utilisent le même journal, mais nous ne le recommandons pas. Les messages de journal sont plus faciles à lire lorsque chaque exécution de travail produit son propre journal.

    Ou

  • Fournir votre propre groupe de journaux, mais permettre au service Science des données de créer automatiquement des journaux personnalisés au début de chaque exécution de travail dans le groupe de journaux spécifié. Si la création automatique de journaux est activée, vous n'avez pas à configurer vous-même les journaux avant chaque exécution de travail. Le journal créé est nommé dans jobrun-<partial-jobrun-ocid>-logs, mais peut être modifié selon les besoins. Cela n'a pas d'incidence sur l'intégration de la journalisation à l'exécution de travail.

Note

Vous gérez le cycle de vie des journaux, y compris ceux créés automatiquement par le service Science des données.

Lorsque le travail et les exécutions de travail sont supprimées, les journaux ne le sont pas.

Pour l'un ou l'autre type de configuration de journalisation, le principal de ressource d'exécution de travail doit avoir des autorisations d'écriture dans vos journaux personnalisés.

Journaux de déploiement de modèle

Lorsque vous intégrez la journalisation pour les déploiements de modèle, des catégories de journaux d'accès et de prévision sont créées :

Journaux d'accès

La catégorie de journal d'accès est un journal personnalisé qui saisit des informations détaillées sur les demandes envoyées au point d'extrémité du modèle. Ces informations incluent l'heure de réception de la demande, les codes d'erreur, etc. Si vous rencontrez des problèmes avec votre déploiement de modèle, les journaux d'accès sont ceux que vous consulterez en premier lieu.

Les métadonnées saisies par les journaux d'accès au déploiement de modèle sont les suivantes :

logEmissionTime

Heure, en UTC, à laquelle le journal a été émis à partir du code.

message

Chemin d'accès à la demande.

modelLatency

Durée de traitement d'une demande sur le serveur de modèles en millisecondes.

opcRequestId

ID demande. Il s'agit de la même valeur requestId que celle extraite dans la réponse.

status

Code de statut de la réponse à la demande.

Par exemple, une entrée de journal d'accès pour le déploiement de modèle peut être :

"data": {
  "logEmissionTime": "2021-01-25T07:23:39.101Z",
  "message": "POST /predict 1.1",
  "modelLatency": 4.43,
  "opcRequestId": "0BC0860C17DC46D79A0A1A7B4F139829",
  "status": 200
}
Journaux de prédiction

Les journaux de prédiction proviennent de la journalisation (stdout et stderr) des appels effectués à l'exécution du code personnalisé dans les fichiers Python d'artefact de modèle. Les journaux de prédiction peuvent émettre des informations utiles sur le modèle et sont entièrement personnalisables. La configuration des journaux d'accès et de prédiction fait partie des actions créer et modifier.

Les métadonnées saisies par les journaux de prédiction de déploiement de modèle sont les suivantes :

MD_OCID

Valeur de l'OCID du déploiement de modèle.

level

Niveau de l'enregistreur automatique. Aussi appelé niveau de gravité du message du journal.

logEmissionTime

Heure, en UTC, à laquelle le journal a été émis à partir du code.

message

Message personnalisé émis à partir du code Python de l'artefact de modèle.

name

Nom de l'enregistreur automatique utilisé.

Par exemple, une entrée de journal de prédiction pour le déploiement de modèle peut être :

"data": {
      "MD_OCID": "ocid1.datasciencemodeldeployment.oc1.iad.amaaaaaav66vvniauqakarfnyvn6gd2qt4fjpv2ffdnrthqyhqpapevmmh6a",
      "level": "ERROR",
      "logEmissionTime": "2021-01-27T08:43:04.029Z",
      "message": "exception :: name 'function' is not defined",
      "name": "root"
    },

Vous pouvez créer deux journaux distincts pour la prédiction et l'accès ou utiliser le même pour les deux.

Configuration des journaux

Créez un groupe de journaux et configurez un journal client dans le service Journalisation si vous n'en avez pas encore :

  1. Ouvrez le menu de navigation et sélectionnez Observabilité et gestion. Sous Journalisation, sélectionnez Groupes de journaux.
  2. Sélectionnez un compartiment que vous êtes autorisé à utiliser et sélectionnez Créer un groupe de journaux.

    Le panneau Créer un groupe de journaux s'affiche.

  3. Entrez les informations suivantes :
    • compartiment : compartiment dans lequel créer le groupe de journaux. Ce champ est prérempli en fonction du compartiment sélectionné.
    • Nom : Nom du groupe de journaux. Le premier caractère du nom d'un groupe de journaux doit être une lettre. Pour plus d'informations, voir Noms de groupe de journaux et de journaux. N'entrez pas d'informations confidentielles.

    • Description : Description conviviale.
    • (Facultatif) Entrez les informations de marquage.
  4. Sélectionnez Créer

    La page de détails des groupes de journaux s'affiche alors.

  5. Sélectionner des journaux.
  6. Sélectionnez Créer un journal personnalisé.
  7. Entrez le nom du journal personnalisé.
  8. (Facultatif) Sélectionnez un autre compartiment.
  9. Sélectionnez le groupe de journaux.
  10. Sélectionnez Ajouter une configuration plus tard, car les travaux et les déploiements de modèle ne sont pas intégrés à la configuration de l'agent du service Journalisation.
  11. Sélectionnez Créer un journal personnalisé.

Accès aux journaux

Vous pouvez accéder aux journaux pour vos travaux et vos déploiements de modèle à partir de la console OCI sous Solutions et plate-forme en sélectionnant le service de journalisation, puis en sélectionnant Rechercher.

Dans la zone Rechercher, sélectionnez Sélectionner les journaux à explorer. Sélectionnez un compartiment, un groupe de journaux et un journal. Appliquez des filtres si nécessaire.

Vous devriez voir les données des journaux dans l'onglet Explorer. Voir Recherche dans les journaux.

Conseil

Cliquez sur Copier pour utiliser l'OCID du journal dans les ressources de travail et de déploiement de modèle. Par exemple, vous pouvez coller un OCID de journal de travail dans plusieurs exécutions de travail pour différentes configurations exécutables simultanément.