使用 IBM Cloud Logs 中的動作與協力廠商服務整合

在 IBM Cloud Logs 中，您可以根據搜尋結果和數值觸發第三方服務，並將資料傳送至這些服務。您可以從檢視和儀表板建立管理動作。

建立動作

如果要建立動作，請執行下列動作:

在左導覽中，按一下 探索日誌 圖示 > 日誌。
在「日誌」視圖中，按一下設定。此設定圖示與左導覽中的圖示不同。您可以在頁面右上方的日誌視圖中找到設定圖示。
按一下 管理動作。
按一下新增動作。
針對 未命名的動作，指定動作的名稱。
在 URL TEMPLATE 中，輸入外部服務的 URL。例如，https://test-my-url.com?type={{ $m.subsystemName === "frontend" ? "Front" : "Back" }}。僅支援 http:// 和 https://。

支援 JavaScript 語法。例如，您可以指定 {{ condition ? "true value" : "false value" }}之類的條件。支援大部分 JavaScript 函數。

您可以在 URL 上包含變數來傳輸資料。如果您鍵入雙大括弧 ({{}})，則會顯示可用變數的清單。
選取與動作相關聯的 資料類型。動作會顯示在選取的環境定義中。
按一下進階以存取選用設定。
若要將動作設為公用，請切換 儲存時設為公用。
若要將動作限制為特定的 應用程式 或 子系統，請從清單中選取值。
按一下 儲存動作

編輯動作

若要編輯現有的動作：

在左導覽中，按一下 探索日誌 圖示 > 日誌。
在「日誌」視圖中，按一下設定。此設定圖示與左導覽中的圖示不同。您可以在頁面右上方的日誌視圖中找到設定圖示。
在動作清單中，按一下要變更的動作。
進行您的變更。
按一下 儲存動作 以儲存變更，或按一下重設以將動作回復為前次儲存的動作版本。

複製動作

如果您想要根據現有動作來建立新動作，則可以複製動作。

在左導覽中，按一下 探索日誌 圖示 > 日誌
在「日誌」視圖中，按一下設定。此設定圖示與左導覽中的圖示不同。您可以在頁面右上方的日誌視圖中找到設定圖示。
在動作清單中，將滑鼠移至您要複製的動作。
按一下複製圖示。即會建立動作的副本。
編輯複製的動作並進行變更。
按一下「儲存動作」儲存您的變更。

在動作功能表上顯示及隱藏動作

您可以配置使用者是否可以觸發動作。

在左導覽中，按一下 探索日誌 圖示 > 日誌。
在「日誌」視圖中，按一下設定。此設定圖示與左導覽中的圖示不同。您可以在頁面右上方的日誌視圖中找到設定圖示。
在動作清單中，按一下您要配置的動作。
按一下 從動作功能表隱藏 圖示，以在動作功能表中不包括使用者的動作。按一下 在動作功能表上顯示 圖示，將動作併入動作功能表中。

觸發動作

執行下列步驟來觸發動作:

在左導覽中，按一下 探索日誌 圖示 > 日誌。
按一下視圖中顯示的資料。即會顯示功能表。
將滑鼠移至動作。顯示可用的動作清單。
按一下動作以觸發動作。

只有配置成顯示在動作功能表中的動作才會列在動作功能表中。

刪除動作

在左導覽中，按一下 探索日誌 圖示 > 日誌。
在「日誌」視圖中，按一下設定。此設定圖示與左導覽中的圖示不同。您可以在頁面右上方的日誌視圖中找到設定圖示。
在動作清單中，按一下您要刪除的動作。
按一下刪除。

刪除會立即完成。系統不會要求您確認是否要刪除動作。

可併入動作中的變數

您可以在 URL 模版中指定變數，將資訊傳送給外部服務。

支援下列變數：

$m.<metadata>: meta 資料變數在日誌中可用。例如，$m.applicationName 或 $m.timestamp。
$d.<key>.<subkey>: 日誌中可用的資料。例如，$d.kubernetes.labels.my_label。
$p.start_time: 所選時間範圍的起始點，以 Unix epoch 時間戳記表示，單位為毫秒。
$p.end_time: 所選時間範圍的終點，以 Unix epoch 時間戳記表示，單位為毫秒。
$p.selected_value: 使用者在使用者介面中選取的值。如果透過按一下索引鍵來啟動，則會包括索引鍵的整個值。

動作範例

下列動作會產生 Jira 問題。

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