Utilisation d'actions dans IBM Cloud Logs pour l'intégration à des services tiers

Sur IBM Cloud Logs, vous pouvez déclencher des services tiers sur la base de vos résultats de recherche et de vos valeurs et envoyer des données à ces services. Vous pouvez créer des actions de gestion à partir de vues et de tableaux de bord.

Création d'une action

Pour créer une action:

Dans la navigation de gauche, cliquez sur l'icône Explorer les journaux > Journaux.
Dans la vue Journaux, cliquez sur l' Paramètres. Cette icône de paramètres n'est pas identique à l'icône de la navigation de gauche. L'icône des paramètres se trouve dans la vue des journaux dans l'angle supérieur droit de la page.
Cliquez sur Gérer les actions.
Cliquez sur Ajouter une action.
Pour Action sans titre, indiquez un nom pour votre action.
Dans le URL TEMPLATE, entrez le URL pour le service externe. Par exemple, https://test-my-url.com?type={{ $m.subsystemName === "frontend" ? "Front" : "Back" }}. Seuls http:// et https:// sont pris en charge.

La syntaxe JavaScript est prise en charge. Par exemple, vous pouvez spécifier des conditions telles que {{ condition ? "true value" : "false value" }}. La plupart des fonctions JavaScript sont prises en charge.

Vous pouvez inclure des variables pour transmettre des données sur le site URL. Si vous entrez des accolades doubles ({{}}), la liste des variables disponibles s'affiche.
Sélectionnez le type de données associé à l'action. L'action s'affiche dans le contexte sélectionné.
Cliquez sur Avancé pour accéder aux paramètres facultatifs.
Pour rendre l'action publique, activez l'option Rendre public lors de la sauvegarde.
Pour limiter l'action à des applications ou à des sous-systèmes spécifiques, sélectionnez des valeurs dans la liste.
Cliquez sur Sauvegarder l'action.

Edition d'une action

Pour modifier une action existante :

Dans la navigation de gauche, cliquez sur l'icône Explorer les journaux > Journaux.
Dans la vue Journaux, cliquez sur l' Paramètres. Cette icône de paramètres n'est pas identique à l'icône de la navigation de gauche. L'icône des paramètres se trouve dans la vue des journaux dans l'angle supérieur droit de la page.
Dans la liste des actions, cliquez sur l'action à modifier.
Effectuez les modifications nécessaires.
Cliquez sur Enregistrer l'action pour enregistrer vos modifications ou sur Réinitialiser pour rétablir la dernière version enregistrée de l'action.

Clonage d'une action

Si vous souhaitez créer une nouvelle action basée sur une action existante, vous pouvez cloner une action.

Dans la navigation de gauche, cliquez sur l'icône Explorer les journaux > Journaux
Dans la vue Journaux, cliquez sur l' Paramètres. Cette icône de paramètres n'est pas identique à l'icône de la navigation de gauche. L'icône des paramètres se trouve dans la vue des journaux dans l'angle supérieur droit de la page.
Dans la liste des actions, survolez l'action que vous souhaitez cloner.
Cliquez sur l'icône Cloner. Un doublon de votre action est créé.
Editez l'action clonée et apportez vos modifications.
Cliquez sur Enregistrer l'action pour enregistrer vos modifications.

Affichage et masquage des actions dans le menu Actions

Vous pouvez indiquer si les actions peuvent être déclenchées par les utilisateurs.

Dans la navigation de gauche, cliquez sur l'icône Explorer les journaux > Journaux.
Dans la vue Journaux, cliquez sur l' Paramètres. Cette icône de paramètres n'est pas identique à l'icône de la navigation de gauche. L'icône des paramètres se trouve dans la vue des journaux dans l'angle supérieur droit de la page.
Dans la liste des actions, cliquez sur l'action que vous souhaitez configurer.
Cliquez sur l'icône Masquer dans le menu des actions pour que l'action ne soit pas incluse pour les utilisateurs dans le menu des actions. Cliquez sur l'icône Afficher le menu des actions pour que l'action soit incluse dans le menu des actions.

Déclenchement d'une action

Pour déclencher une action, procédez comme suit:

Dans la navigation de gauche, cliquez sur l'icône Explorer les journaux > Journaux.
Cliquez sur les données affichées dans la vue. Un menu s'ouvre.
Placez le pointeur de la souris sur les actions. La liste des actions disponibles s'affiche.
Cliquez sur l'action pour la déclencher.

Seules les actions configurées pour être affichées dans le menu Actions sont répertoriées dans le menu Actions.

Suppression d'une action

Dans la navigation de gauche, cliquez sur l'icône Explorer les journaux > Journaux.
Dans la vue Journaux, cliquez sur l' Paramètres. Cette icône de paramètres n'est pas identique à l'icône de la navigation de gauche. L'icône des paramètres se trouve dans la vue des journaux dans l'angle supérieur droit de la page.
Dans la liste des actions, cliquez sur l'action à supprimer.
Cliquez sur Supprimer.

La suppression est effectuée immédiatement. Vous n'êtes pas invité à confirmer la suppression de l'action.

Variables pouvant être incluses dans une action

Vous pouvez spécifier des variables dans un modèle URL pour transmettre des informations à votre service externe.

Les variables suivantes sont prises en charge :

$m.<metadata>: Les variables de métadonnées sont disponibles dans les journaux. Par exemple, $m.applicationName ou $m.timestamp.
$d.<key>.<subkey>: Données disponibles dans le journal. Par exemple, $d.kubernetes.labels.my_label.
$p.start_time: Le début de l'intervalle de temps sélectionné sous la forme d'un horodatage d'époque Unix, en millisecondes.
$p.end_time: La fin de l'intervalle de temps sélectionné sous la forme d'un horodatage d'époque Unix, en millisecondes.
$p.selected_value: Valeur sélectionnée par l'utilisateur dans l'interface utilisateur. Si cette option est activée en cliquant sur une clé, la valeur entière de la clé est incluse.

Exemple d'action

L'action suivante génère un problème Jira.

http://<company_name>.atlassian.net//secure/CreateIssueDetails!init.jspa?pid=<Jira_PID>&issuetype=<Jira_issueType>&description={{$d.logRecord.body}}&summary={{$d.msg}}