Utilizzo delle azioni in IBM Cloud Logs per l'integrazione con servizi di terzi

In IBM Cloud Logs è possibile attivare servizi di terze parti in base ai risultati e ai valori della ricerca e inviare dati a tali servizi. È possibile creare azioni di gestione da viste e dashboard.

Creazione di un'azione

Per creare un'azione:

  1. Nella parte sinistra di navigazione, fai clic sull'icona Esplora log Icona Esplora log > Log.

  2. Nella vista Log, fare clic sull'icona Impostazioni Impostazioni. Questa icona di impostazioni non è la stessa dell'icona nella navigazione a sinistra. L'icona delle impostazioni è disponibile nella vista dei log nella parte superiore destra della pagina.

  3. Fare clic su Gestisci azioni.

  4. Fai clic su Aggiungi nuova azione.

  5. Per Azione senza titolo, specificare un nome per l'azione.

  6. Nel TEMPIO URL, inserire il sito URL per il servizio esterno. Ad esempio, https://test-my-url.com?type={{ $m.subsystemName === "frontend" ? "Front" : "Back" }}. Sono supportati solo http:// e https://.

    La sintassi JavaScript è supportata. Ad esempio, è possibile specificare condizioni come {{ condition ? "true value" : "false value" }}. Sono supportate la maggior parte delle funzioni JavaScript.

    Si possono includere variabili per passare i dati su URL. Se si immettono parentesi graffe doppie ({{}}), viene visualizzato un elenco di variabili disponibili.

  7. Selezionare il tipo di dati associato all'azione. L'azione viene visualizzata nel contesto selezionato.

  8. Fare clic su Avanzate per accedere alle impostazioni facoltative.

  9. Per rendere pubblica l'azione, attivare Rendi pubblico quando salvato.

  10. Per limitare l'azione a Applicazioni o Sottosistemi specifici, selezionare i valori dall'elenco.

  11. Fare clic su Salva azione

Modifica di un'azione

Per modificare un'azione esistente:

  1. Nella parte sinistra di navigazione, fai clic sull'icona Esplora log Icona Esplora log > Log.

  2. Nella vista Log, fare clic sull'icona Impostazioni Impostazioni. Questa icona di impostazioni non è la stessa dell'icona nella navigazione a sinistra. L'icona delle impostazioni è disponibile nella vista dei log nella parte superiore destra della pagina.

  3. Nell'elenco di azioni, fare clic sull'azione da modificare.

  4. Apportare le modifiche.

  5. Fare clic su Salva azione per salvare le modifiche o su Reimposta per ripristinare l'azione all'ultima versione salvata dell'azione.

Clonazione di un'azione

Se si desidera creare una nuova azione in base a un'azione esistente, è possibile clonare un'azione.

  1. Nella parte sinistra di navigazione, fai clic sull'icona Esplora log icona Esplora log > Log

  2. Nella vista Log, fare clic sull'icona Impostazioni Impostazioni. Questa icona di impostazioni non è la stessa dell'icona nella navigazione a sinistra. L'icona delle impostazioni è disponibile nella vista dei log nella parte superiore destra della pagina.

  3. Nell'elenco di azioni, passa con il mouse sull'azione che vuoi clonare.

  4. Fare clic sull'icona Clona. Viene creato un duplicato della tua azione.

  5. Modifica l'azione clonata e apporta le modifiche.

  6. Fare clic su Salva azione per salvare le modifiche.

Visualizzazione e nascondimento delle azioni nel relativo menu

È possibile configurare se le azioni possono essere attivate dagli utenti.

  1. Nella parte sinistra di navigazione, fai clic sull'icona Esplora log Icona Esplora log > Log.

  2. Nella vista Log, fare clic sull'icona Impostazioni Impostazioni. Questa icona di impostazioni non è la stessa dell'icona nella navigazione a sinistra. L'icona delle impostazioni è disponibile nella vista dei log nella parte superiore destra della pagina.

  3. Nell'elenco di azioni, fare clic sull'azione che si desidera configurare.

  4. Fare clic sull'icona Nascondi dal menu azioni per non includere l'azione per gli utenti nel menu azioni. Fare clic sull'icona Mostra sul menu azioni per includere l'azione nel menu Azioni.

Attivazione di un'azione

Attivare un'azione effettuando le seguenti operazioni:

  1. Nella parte sinistra di navigazione, fai clic sull'icona Esplora log Icona Esplora log > Log.

  2. Fare clic sui dati visualizzati nella vista. Verrà visualizzato un menu.

  3. Passare con il mouse sulle azioni. Viene visualizzato l'elenco delle azioni disponibili.

  4. Fare clic sull'azione per attivare l'azione.

    Solo le azioni configurate per essere visualizzate nel menu Azioni vengono elencate nel menu Azioni.

Eliminazione di un'azione

  1. Nella parte sinistra di navigazione, fai clic sull'icona Esplora log Icona Esplora log > Log.

  2. Nella vista Log, fare clic sull'icona Impostazioni Impostazioni. Questa icona di impostazioni non è la stessa dell'icona nella navigazione a sinistra. L'icona delle impostazioni è disponibile nella vista dei log nella parte superiore destra della pagina.

  3. Nell'elenco di azioni, fare clic sull'azione che si desidera eliminare.

  4. Fai clic su Delete.

    L'eliminazione viene eseguita immediatamente. Non viene richiesto di confermare che si desidera eliminare l'azione.

Variabili che possono essere incluse in un'azione

È possibile specificare variabili in un modello URL per passare informazioni al servizio esterno.

Sono supportate le seguenti variabili:

$m.<metadata>
Le variabili dei metadati sono disponibili nei log. Ad esempio, $m.applicationName o $m.timestamp.
$d.<key>.<subkey>
I dati disponibili nel log. Ad esempio, $d.kubernetes.labels.my_label.
$p.start_time
L'inizio dell'intervallo di tempo selezionato come timestamp dell'epoch Unix, in millisecondi.
$p.end_time
La fine dell'intervallo di tempo selezionato come timestamp dell'epoch Unix, in millisecondi.
$p.selected_value
Il valore selezionato dall'utente nell'IU. Se attivato facendo clic su una chiave, viene incluso l'intero valore della chiave.

Azione di esempio

La seguente azione genera un problema Jira.

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