Création d'une configuration d'agent
Créez une configuration d'agent dans la journalisation pour ingérer les événements de vos applications dans un journal personnalisé.
Pour créer une configuration d'agent, vous devez d'abord installer l'agent basé sur fluentd Oracle. Pour plus de détails, voir Installation de l'agent.
- Ouvrez le menu de navigation et sélectionnez Observabilité et gestion. Sous Journalisation, sélectionnez Configurations d'agent.
- Sous Portée de la liste, sélectionnez un compartiment que vous êtes autorisé à utiliser.
- Sélectionnez Créer une configuration d'agent.
- Dans le panneau Créer une configuration d'agent, entrez un nom et une description pour la configuration. Évitez d'entrer des informations confidentielles.
- Sélectionnez le compartiment dans lequel créer la configuration.
-
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 fait référence à un groupe d'instances que vous pouvez créer dans la fonction IAM de la console. Pour plus d'informations, voir À propos des groupes dynamiques. Sélectionnez un groupe dynamique dans la liste Groupe.
- Groupe d'utilisateurs : Le groupe d'utilisateurs fait référence à la fonction Groupes IAM de la console. Pour plus d'informations, voir Gestion des groupes. Sélectionnez un groupe d'utilisateurs dans la liste Groupe.
-
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.
Note
Cinq groupes au maximum par configuration sont autorisés et un hôte peut être dans cinq groupes au maximum. -
Sous Configuration d'agent, définissez le format des journaux (les journaux que vous voulez surveiller) dans Configurer les entrées de journal. Sélectionnez l'une des options de la liste Type d'entrée :
- Pour journal d'événements Windows, entrez un nom d'entrée et sélectionnez un ou plusieurs canaux d'événement.
- Pour Chemin d'accès au journal, entrez un nom d'entrée et un ou plusieurs chemins d'accès au fichier. Par exemple, /<log_path>/<log_name>.
Vous pouvez spécifier plusieurs chemins d'accès au fichier journal, séparés par une virgule (,). Pour plus de renseignements, consultez la page 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>* }}
-
Sélectionnez Options avancées de l'analyseur et, dans le panneau Options avancées de l'analyseur, sélectionnez un analyseur pour spécifier comment analyser le journal. Certains analyseurs nécessitent des entrées supplémentaires et offrent plus d'options, selon le type sélectionné.
Par exemple, pour JSON, vous devez sélectionner une valeur de Type de temps dans la liste, tandis que vous pouvez éventuellement spécifier des paramètres d'heure d'événement et de champ vide. Pour REGEXP, vous pouvez spécifier l'expression rationnelle pour la mise en correspondance des journaux, ainsi que le format d'heure. Pour plus d'informations, voir Entrées de journal et analyseurs.Important
Le type d'analyseur AUCUN est requis, même si vous ne voulez pas spécifier un type d'analyseur particulier. -
Sous Sélectionner la destination de journal, le groupe d'utilisateurs ou le groupe dynamique de la configuration que vous sélectionnez dans Compartiment doit être autorisé à utiliser le compartiment.
Sélectionnez le groupe de journaux et le nom du journal dans les listes correspondantes.
Le nom du journal peut uniquement pointer vers un journal personnalisé et le journal personnalisé doit exister dans le groupe de journaux sélectionné pour que la configuration fonctionne.
- (Facultatif) Sélectionnez Afficher les options supplémentaires. Sous Mesures opérationnelles de l'agent de journalisation, sélectionnez Activer pour aider à surveiller et à identifier les problèmes potentiels avec l'agent.
Sous Destination d'émission, sélectionnez le compartiment et spécifiez un espace de noms, et éventuellement spécifiez le groupe de ressources dans les champs correspondants.Note
Bien que le groupe de ressources soit facultatif, la valeur par défaut est "defaultGroup" si rien n'est sélectionné.Sous Mesures opérationnelles, sélectionnez les mesures opérationnelles que vous souhaitez activer pour la configuration d'agent.- Heartbeat : État de l'agent unifié de surveillance. La valeur 1 indique que l'agent est disponible et la valeur 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 de l'agent unifié de surveillance de l'instance, système d'exploitation, architecture, région, domaine de disponibilité et ID instance.
- RestartMetric : Contrairement à la mesure Heartbeat, qui est périodique, RestartMetric est envoyé une seule fois pendant la durée de vie de l'agent, c'est-à-dire lorsque l'agent est redémarré. Les redémarrages de surveillance sont essentiels pour comprendre la stabilité de l'agent. Les redémarrages fréquents peuvent indiquer des dysfonctionnements du système et être conscients des redémarrages inattendus peuvent aider les opérateurs à résoudre des problèmes de configuration ou des contraintes de ressources.
Dimensions : ID instance.
- EmitRecords : Nombre total d'enregistrements de journal émis. Un enregistrement correspond aux lignes de journal envoyées au serveur dorsal. Cette mesure fournit des informations sur l'augmentation et la diminution du nombre de lignes de journal ingérées et du volume de journaux en cours de traitement. Une baisse 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 des journaux.
Dimensions : ID instance et marqueur.
- BufferSpaceAvailable : Espace tampon disponible exprimé en pourcentage. La valeur commence à 100 et diminue lorsque la quantité de tampon est utilisée. L'agent utilise des tampons pour gérer les pointes de données entrantes et la contrepression potentielle des sorties. La surveillance de cette mesure vous aide à vous assurer de ne pas manquer d'espace tampon, ce qui pourrait entraîner une perte ou une contrepression des données. Si l'espace tampon est constamment faible, vous devrez peut-être optimiser la configuration de l'agent et affecter plus de ressources.
Dimensions : ID instance et marqueur.
- ShowFlushCount : Nombre total de vidages lents. Le flushing fait référence à l'envoi de données en mémoire tampon à la destination prévue. 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 incrémenté lorsque le vidage du tampon est supérieur à 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 instance et marqueur.
- RollbackCount : Nombre total de fois où l'agent repositionne une transaction, car il n'a pas pu vider la mémoire tampon vers la destination d'émission. Les repositionnements se produisent généralement lorsqu'une écriture ou try_write échoue ou qu'il existe des problèmes avec le service de journalisation OCI, des problèmes de réseau ou des problèmes de configuration. Un nombre élevé de repositionnements est un indicateur clair des problèmes de fiabilité dans le pipeline de journalisation qui nécessitent une enquête.
Dimensions : ID instance et marqueur.
- RetryCount : Suit le nombre de tentatives effectuées par l'agent pour réessayer une opération d'envoi de données après un échec. Les nouvelles tentatives indiquent des problèmes transitoires avec la livraison des données, et un nombre élevé de nouvelles tentatives peut indiquer l'instabilité du réseau. Bien que les repositionnements puissent traiter des problèmes transactionnels plus importants, les nouvelles tentatives indiquent souvent des interruptions plus petites, voire plus fréquentes.
Dimensions : ID instance et marqueur.
Une fois la configuration d'agent créée, vous pouvez voir les mesures opérationnelles activées lors de l'obtention des détails d'une configuration d'agent.
- Heartbeat : État de l'agent unifié de surveillance. La valeur 1 indique que l'agent est disponible et la valeur 0 indique que l'agent ne répond pas. Cette mesure est toujours activée et ne peut pas être désactivée.
- (Facultatif) Ajoutez un ou plusieurs marqueurs à la configuration de l'agent : Sélectionnez Afficher les options supplémentaires pour afficher la section Ajouter des marqueurs.
Si vous êtes autorisé à créer une ressource, vous pouvez également appliquer des marqueurs à structure libre à cette ressource. Pour appliquer un marqueur défini, vous devez être autorisé à utiliser l'espace de noms de marqueur. Pour plus d'informations sur le marquage, voir Marqueurs de ressource. Si vous ne savez pas si vous devez appliquer des marqueurs, ignorez cette option ou demandez à un administrateur. Vous pouvez appliquer des marqueurs plus tard.
- (Facultatif) Sélectionnez Enregistrer en tant que pile pour enregistrer la configuration de ressources en tant que pile.
Pour plus d'informations, voir Création d'une pile à partir d'une page de création de ressource.
- Sélectionnez Créer.
La configuration d'agent est créée et apparaît dans 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 la liste complète des paramètres et valeurs des commandes de l'interface de ligne de commande, voir Informations de référence sur les commandes de l'interface.
Exécutez l'opération CreateUnifiedAgentConfiguration pour créer une configuration d'agent pour la journalisation.