Création d'une configuration d'agent

• Console
• CLI
• API

• 1. Ouvrez le menu de navigation et sélectionnez Observation et gestion. Sous Journalisation, sélectionnez Configurations d'agent.
  2. Sous Portée de la liste, sélectionnez un compartiment dans lequel vous êtes autorisé à travailler.
  3. Sélectionnez Créer une configuration d'agent.
  4. Dans le panneau Créer une configuration d'agent, entrez le nom et la description de la configuration. Evitez de saisir des informations confidentielles.
  5. Sélectionnez le compartiment dans lequel créer la configuration.
  6. Sous Groupes d'hôtes, où vous définissez les machines virtuelles qui s'appliquent à cette configuration, sélectionnez l'une des options suivantes dans la liste Type de groupe :
     • Groupe dynamique : le groupe dynamique désigne un groupe d'instances que vous pouvez créer dans la fonctionnalité IAM de la console. Pour plus d'informations, reportez-vous à A propos des groupes dynamiques. Sélectionner un groupe dynamique dans la liste Groupe.
     • Groupe d'utilisateurs : le terme groupe d'utilisateurs fait référence à la fonctionnalité Groupes IAM de la console. Pour plus d'informations, reportez-vous à Gestion des groupes. Sélectionnez un groupe d'utilisateurs dans la liste Groupe.
  7. Pour ajouter d'autres groupes, sélectionnez + Un autre groupe d'hôtes.

     Vous pouvez ajouter une combinaison de types de groupe pour la configuration d'agent.

     Remarque
     
     Au maximum, cinq groupes par configuration sont autorisés, et un hôte ne peut pas se trouver que dans cinq groupes différents.
  8. Sous Configuration de l'agent, définissez le format des journaux (journaux à surveiller) dans Configurer les entrées de journal. Sélectionnez l'une des options de la liste Type d'entrée :
     • Dans Journal d'événement Windows, saisissez un nom d'entrée et sélectionnez des canaux d'événement.
     • Pour Chemin de journal, entrez un nom d'entrée et un ou plusieurs chemins de fichier. Par exemple, /<chemin_journal>/<nom_journal>.

     Vous pouvez indiquer plusieurs chemins de fichier journal, séparés par une virgule (,). Pour plus d'informations, reportez-vous à https://docs.fluentd.org/input/tail#path.

     <source>
     @type tail
     tag 757261.oc_oslogs_linux
     path /var/log/.log,/var/log/.out,/var/log/dmesg,var/log/grubby,/var/log/messages*,
      var/log/secure,/var/log/auth,/var/log/acpid,/root/.bash_history
     pos_file /etc/unifiedmonitoringagent/pos/757261-oc_oslogs_linux.pos
     path_key tailed_path
     </source>

     Exemple de configuration :

     {{path C:\Program Files (x86)\<application>\<directory>*, 
      C:\Program Files (x86)\<application>\<application_logs_directory>\<directory>* }}

  9. Sélectionnez Options d'analyseur avancées et, dans le panneau Options d'analyseur avancées, sélectionnez un analyseur pour indiquer comment analyser le journal. Certains analyseurs nécessitent des entrées supplémentaires et ont plus d'options, selon le type choisi.
     Par exemple, pour JSON, vous devez sélectionner un type de date/heure dans la liste, tandis que vous pouvez éventuellement indiquer l'heure de l'événement et les paramètres de champ NULL. Pour REGEXP, vous pouvez indiquer l'expression régulière pour les journaux correspondants, ainsi que le format d'heure. Pour plus d'informations, reportez-vous à Analyseurs et entrées de journal.

     Important
     
     Le type d'analyseur NONE est requis, même si vous ne souhaitez pas spécifier de type d'analyseur particulier.
  10. Sous Sélectionner une destination de journal, le groupe d'utilisateurs ou le groupe dynamique de la configuration que vous sélectionnez dans Compartiment doit être autorisé à travailler dans le compartiment.

      Sélectionnez le groupe de journaux et le nom de journal dans les listes correspondantes.

      Le nom de journal peut uniquement désigner un journal personnalisé qui doit exister dans le groupe de journaux choisi pour que la configuration fonctionne.

  11. (Facultatif) Sélectionnez Afficher les options supplémentaires. Sous Mesures opérationnelles d'agent de journalisation, sélectionnez Activer pour aider à surveiller et à identifier les problèmes potentiels avec l'agent.
      Sous Emettre la destination, sélectionnez le compartiment et indiquez un espace de noms, et indiquez éventuellement le groupe de ressources dans les champs correspondants.

      Remarque
      
      Bien que le groupe de ressources soit facultatif, il prend par défaut la valeur "defaultGroup" si aucun élément n'est sélectionné.

      Sous Mesures opérationnelles, sélectionnez les mesures opérationnelles à activer pour la configuration d'agent.

      • Signal d'activité : état de l'agent de surveillance unifié. La valeur 1 indique que l'agent est disponible et 0 indique que l'agent ne répond pas. Cette mesure est toujours activée et ne peut pas être désactivée.

        Dimensions : version, système d'exploitation, architecture, région, domaine de disponibilité et ID d'instance de l'agent de surveillance unifié de l'instance.

      • RestartMetric : contrairement à la mesure Heartbeat, qui est périodique, RestartMetric n'est envoyé qu'une seule fois au cours de la durée de vie de l'agent, c'est-à-dire lors du redémarrage de l'agent. La surveillance des redémarrages est essentielle pour comprendre la stabilité des agents. Les redémarrages fréquents peuvent indiquer des dysfonctionnements du système et la détection de redémarrages inattendus peut aider les opérateurs à résoudre les problèmes de configuration ou les contraintes de ressources.

        Dimensions : ID d'instance.

      • EmitRecords : nombre total d'enregistrements de journal émis. Un enregistrement correspond aux lignes de journal envoyées au back-end. Cette mesure fournit des informations sur l'augmentation et la diminution du nombre de lignes de journal incluses, ainsi que sur le volume de journaux en cours de traitement. Une chute ou une augmentation soudaine de ce nombre peut signaler des problèmes dans le pipeline de journalisation. Par exemple, certaines lignes de journal peuvent être rejetées et non incluses lors de l'ingestion de journal.

        Dimensions : ID d'instance et balise.

      • BufferSpaceAvailable : espace de tampon disponible exprimé en pourcentage. La valeur commence à 100 et diminue à mesure que la quantité de tampon est utilisée. L'agent utilise des tampons pour gérer les rafales de données entrantes et la contre-pression potentielle des sorties. La surveillance de cette mesure permet de s'assurer que vous ne manquez pas d'espace de tampon, ce qui pourrait entraîner une perte de données ou une contre-pression. Si l'espace du tampon est toujours faible, vous devrez peut-être optimiser la configuration de l'agent et allouer davantage de ressources.

        Dimensions : ID d'instance et balise.

      • ShowFlushCount : nombre total de vidages lents. Le vidage fait référence à l'envoi de données mises en mémoire tampon vers la destination voulue. Un vidage lent signifie que le vidage des données du tampon vers sa destination prend plus de temps que le seuil défini. Ce nombre est augmenté lorsque le vidage du tampon dépasse 20 secondes. La surveillance des vidages lents permet d'identifier les problèmes de performances. Si les vidages sont constamment lents, le tampon peut se remplir plus rapidement que les données ne peuvent être effacées, ce qui entraîne des problèmes de perte de données ou de contre-pression.

        Dimensions : ID d'instance et balise.

      • RollbackCount : nombre total de fois où l'agent annule (rollback) une transaction car il n'a pas réussi à vider le tampon vers la destination d'émission. Les annulations se produisent généralement en cas d'échec d'une écriture ou d'une commande try_write, ou de problèmes liés au service OCI Logging, de problèmes de réseau ou de configuration. Le nombre élevé d'annulations est un indicateur clair des problèmes de fiabilité dans le pipeline de journalisation qui nécessitent une investigation.

        Dimensions : ID d'instance et balise.

      • RetryCount : permet de suivre le nombre de tentatives d'une opération d'envoi de données effectuées par l'agent après un échec. Les nouvelles tentatives indiquent des problèmes transitoires de transmission des données, et un nombre élevé de nouvelles tentatives peut indiquer une instabilité du réseau. Bien que les annulations puissent traiter des problèmes transactionnels plus importants, les nouvelles tentatives indiquent souvent des perturbations plus petites, voire plus fréquentes.

        Dimensions : ID d'instance et balise.

      Une fois la configuration d'agent créée, vous pouvez visualiser les mesures opérationnelles activées lors de l'obtention des détails d'une configuration d'agent.

  12. (Facultatif) Ajoutez des balises à la configuration d'agent : sélectionnez Afficher les options supplémentaires pour afficher la section Ajouter des balises.
      Si vous disposez des droits d'accès permettant de créer une ressource, vous disposez également de ceux permettant de l'appliquer à cette ressource. Pour appliquer une balise defined, vous devez être autorisé à utiliser la balise namespace. Pour plus d'informations sur le balisage, reportez-vous à Balises de ressource. Si vous n'êtes pas sûr d'appliquer des balises, ignorez cette option ou demandez à un administrateur. Vous pouvez appliquer des balises ultérieurement.
  13. (Facultatif) Sélectionnez Enregistrer en tant que pile pour enregistrer la configuration de ressource en tant que pile.
      Pour plus d'informations, reportez-vous à Création d'une pile à partir d'une page de création de ressource.
  14. Sélectionnez Créer.

  La configuration d'agent est créée et apparaît sur la page Configurations d'agent.

• Utilisez la commande oci logging agent-configuration create et les paramètres requis pour créer une configuration d'agent pour la journalisation :

  oci logging agent-configuration create compartment-id compartment_ocid --is-enabled [true|false] --service-configuration service_configuration [OPTIONS]

  Pour obtenir la liste complète des paramètres et des valeurs des commandes d'interface de ligne de commande, reportez-vous à Référence de commande d'interface de ligne de commande.

• Exécutez l'opération CreateUnifiedAgentConfiguration pour créer une configuration d'agent pour la journalisation.