Configurer la collection de commandes du système d'exploitation

Préalables à la configuration de la collecte de la sortie de commande du système d'exploitation

Effectuez les tâches préalables suivantes avant de configurer la collecte des journaux :

• Créez un script personnalisé composé d'une commande de système d'exploitation, dont la sortie peut être collectée dans Oracle Log Analytics en tant que journaux. La sortie STDOUT du script est envoyée en tant que données utiles par l'agent vers le nuage. Les données utiles STDOUT peuvent être une seule entrée de journal ou plusieurs entrées de journal. Assurez-vous que l'analyseur utilisé dans la source Oracle Log Analytics peut l'analyser. En outre, le script doit être en mesure de gérer les conditions d'erreur et de rechercher les préalables.

  Stockez votre script personnalisé dans le dossier agent_inst/state/laStorage/os_cmd/scripts du dossier d'installation de l'agent. Par conséquent, le chemin absolu de stockage du script est :

  • Pour Oracle Management Agent : /opt/oracle/mgmt_agent/agent_inst/state/laStorage/os_cmd/scripts
  • Pour le plugiciel Agent Oracle Cloud - Agent de gestion : /var/lib/oracle-cloud-agent/plugins/oci-managementagent/polaris/agent_inst/state/laStorage/os_cmd/scripts

• Des autorisations de fichier spéciales peuvent être nécessaires pour exécuter des commandes particulières dans le script. Configurez manuellement ces autorisations sur l'hôte de l'agent. Le script et toutes les autres commandes/scripts exécutés par le script doivent avoir l'autorisation execute (Exécuter) pour l'utilisateur de l'agent de gestion.

Flux global pour la collecte des journaux de commandes du système d'exploitation

Les tâches de haut niveau suivantes permettent de collecter la sortie d'un script de commande du système d'exploitation :

• Installez l'agent de gestion sur l'hôte où vous voulez exécuter les scripts de commande du système d'exploitation et générer la sortie qui doit être collectée dans Oracle Log Analytics. Voir Configurer la collecte continue des journaux à l'aide de l'agent de gestion.

• Créez une entité pour identifier l'hôte de votre agent dans Oracle Log Analytics. L'entité doit se trouver sur le même hôte que l'agent de gestion où le script sera exécuté. L'exécution de la commande du système d'exploitation distant n'est pas prise en charge. En général, l'entité est créée automatiquement lorsque vous installez l'agent OMA. Voir Créer une entité pour représenter votre ressource émettrice de journaux.

• Créez un analyseur qui peut analyser la sortie du script. Cet analyseur doit être utilisé dans la source qui sera identifiée à l'étape suivante. Voir Créer un analyseur.
• Identifiez une source existante ou créez une source de journaux de type Commande de système d'exploitation. Voir Créer une source de commandes du système d'exploitation.
• Vérifiez si vous voulez configurer la propriété de collection d'agents customized_schedule pour définir l'intervalle de collecte de la collection de commandes du système d'exploitation. La valeur par défaut est 30 seconds. Vous pouvez mettre à jour la programmation au niveau de l'agent, de la source, de l'entité ou de l'association à l'aide des propriétés de collection d'agents. Voir Propriétés d'agent que vous pouvez modifier et Modifier les propriétés d'agent.

• Associez les entités à la source que vous avez créée précédemment. Voir Configurer une nouvelle association source-entité.

  Une fois l'association terminée, l'agent commence à exécuter la commande du système d'exploitation sur une base périodique, le STDOUT de la commande est collecté en tant que données de journal et les données de journal commencent à circuler dans Oracle Log Analytics.

• Consultez les données de journal dans l'explorateur de journaux en sélectionnant la source de commandes du système d'exploitation que vous avez créée précédemment. Voir Filtrer les journaux par attribut source.

Si les données de journal ne sont pas apparues dans l'explorateur de journaux une fois la configuration terminée, vous pouvez rechercher les avertissements de collecte d'agent pour tout problème. Les avertissements suivants sont spécifiquement liés à la collecte de sortie des commandes du système d'exploitation :

• Échec de l'exécution de l'application externe : Une erreur est survenue lors de l'exécution du script ou la commande du système d'exploitation n'est pas prise en charge.

• Application externe introuvable : Script introuvable, aucune autorisation de lecture/exécution sur le script.

Voir Voir les avertissements de collecte d'agent.

Facteurs importants à prendre en compte lors de la configuration de la collecte de commandes du système d'exploitation

• Utilisez le chemin complet des commandes dans les scripts. Par exemple, utilisez /bin/sudo au lieu de sudo.

• Les scripts s'exécutent avec le même utilisateur que l'agent de gestion. Ceci est important lors de la lecture ou de l'écriture de fichiers en script.

• La sortie générée par le script sur Standard Out (STDOUT) et Standard Error (STDERR) est collectée sous forme de texte pour extraire les entrées de journal.

• Les mots ou préfixes suivants ne sont pas pris en charge dans la commande du système d'exploitation ou le nom du script : sh, bash, csh, zsh, ksh, dash, cmd

• Les caractères suivants ne sont pas pris en charge dans la commande du système d'exploitation ou le nom du script : |, &, ;, >, <

• Les séquences de parcours de répertoire parent suivantes ne sont pas prises en charge dans la commande du système d'exploitation ou le nom du script : /../ ou \..\. De plus, la commande du système d'exploitation ne peut pas se terminer par /.. ou \...

• La variable d'environnement suivante est transmise aux scripts de l'agent. Vous pouvez utiliser la variable dans les scripts.

  • LA_SOURCE_COMMAND_ID : Il s'agit de l'ID modèle généré en interne de la commande dans la source de journaux. Il peut être utilisé pour différencier les instances de script si le même script est donné dans plusieurs commandes.