airflow.providers.pagerduty.hooks.pagerduty_events
¶
用於從 PagerDuty 發送或接收資料以及創建 PagerDuty 事件的 Hook。
模組內容¶
類別¶
此類別可用於與 Pagerduty Events API 互動。 |
- class airflow.providers.pagerduty.hooks.pagerduty_events.PagerdutyEventsHook(integration_key=None, pagerduty_events_conn_id=None)[原始碼]¶
繼承自:
airflow.hooks.base.BaseHook
此類別可用於與 Pagerduty Events API 互動。
- 它接受 Events API 令牌和具有 Events API 令牌的 PagerDuty 連線
(即整合金鑰)作為密碼/Pagerduty API 令牌。如果兩者都提供,將使用該令牌。
- 參數
- send_event(summary, severity, source=airflow', action='trigger', dedup_key=None, custom_details=None, group=None, component=None, class_type=None, images=None, links=None)[原始碼]¶
為服務整合創建事件。
- 參數
summary (str) – 事件摘要
severity (str) – 事件嚴重性,需要是以下之一:info、warning、error、critical
source (str) – 發生問題的系統的特定人類可讀的唯一識別符,例如主機名稱。
action (str) – 事件動作,需要是以下之一:trigger、acknowledge、resolve。如果未指定,則預設為 trigger。
dedup_key (str | None) – 一個識別為給定事件觸發警報的字串。acknowledge 和 resolve 動作是必需的。
custom_details (Any | None) – 來自事件的自由格式的詳細資訊。可以是字典或字串。如果傳遞字典,它將在 PagerDuty 中顯示為表格。
group (str | None) – 一個來源的叢集或分組。例如,來源 “prod-datapipe-02” 和 “prod-datapipe-03” 可能都屬於 “prod-datapipe” 的一部分
component (str | None) – 受影響系統中損壞的部分或組件。
class_type (str | None) – 事件的類別/類型。
images (list[Any] | None) – 要包含的圖片列表。列表中的每個字典都接受以下鍵:src:附加到事件的圖片的來源 (URL)。此圖片必須通過 HTTPS 提供。href:[選填] 使圖片成為可點擊連結的 URL。alt:[選填] 圖片的替代文字。
links (list[Any] | None) – 要包含的連結列表。列表中的每個字典都接受以下鍵:href:要附加的連結的 URL。text:[選填] 描述連結用途的純文字,並可用作連結的文字。
- 返回
PagerDuty Events API v2 回應。
- 返回類型
- static prepare_event_data(summary, severity, source, custom_details, component, group, class_type, action, dedup_key, images, links, action_key_name='action')[原始碼]¶
為 send_event / post(‘/v2/enqueue’) 方法準備事件資料。
- create_change_event(summary, source='airflow', custom_details=None, timestamp=None, links=None)[原始碼]¶
為服務整合創建變更事件。
- 參數
summary (str) – 事件摘要
source (str) – 發生問題的系統的特定人類可讀的唯一識別符,例如主機名稱。
custom_details (Any | None) – 來自事件的自由格式的詳細資訊。可以是字典或字串。如果傳遞字典,它將在 PagerDuty 中顯示為表格。
timestamp (datetime.datetime | None) – 發射工具偵測或產生事件的時間。
links (list[Any] | None) – 要包含的連結列表。列表中的每個字典都接受以下鍵:href:要附加的連結的 URL。text:[選填] 描述連結用途的純文字,並可用作連結的文字。
- 返回
PagerDuty Change Events API v2 回應。
- 返回類型