2022-05-24

Mac版 Chrome のプロファイルのショートカット

Chrome

Mac版 Chrome のプロファイル切替のショートカットが欲しかったのでメモ。

調べて見ると「デスクトップショートカットを作成」で作成できますという記事が沢山出てきたのですが、Mac版だと存在しないようです。

Windows版
Mac版 (項目が無い)

作成時も作成後の設定メニューにも見当たりません。

結論

Dock から開けます。

Dock の Chrome アイコンを右クリック (または Control + クリック)で表示されるメニューの中に プロファイル が含まれています。

結果的に調べる程の話では無く、灯台下暗しでした。

参考

プロファイル機能
- Chrome ブラウザを設定する - Google Workspace ラーニングセンター
  - アカウントごとに別々の Chrome プロファイルを作成しておくと、毎回ログアウトしなくても、仕事用アカウントとその他の Google アカウント（個人アカウントやテストアカウントなど）を切り替えることができます。
Automator や Launcher 使ってショートカットを作成する記事
- chrome のユーザー切り替えのショートカット - スタック・オーバーフロー
- MacのGoogle Chromeでデスクトップ・ドックにユーザープロファイル別のショートカットを作る方法 | iPhoneアプリ個人開発とライフハック

2022-04-19

AWS から PagerDuty への通知連携(まとめ)

AWS PagerDuty

一通り実行結果を確認できたのでまとめます。
AWSからの送信を題材にしていますが、他サービスからの連携でも利用できると思います。

参考URL
イベントフロー
- 対象外とした機能
  - App
  - Service Rule
選択肢
コード化
- Terraform 未サポートリソース
まとめのまとめ

参考URL

Knowledge Base
- 機能概要、ベストプラクティス、利用方法などのドキュメント
Integrations
- インテグレーションの検索とガイドへのリンク
PagerDuty Developer Platform and Documentation
- API提供機能の概要、API Reference などのドキュメント
- トップページ以外はURLにランダム文字列を含んでおり、不定期に変わってそう (例：https://developer.pagerduty.com/docs/ZG9jOjQ2NDA2-introduction)
PagerDuty Community
- コミュニティフォーラム
- サポートへの問合せ前に利用を推奨される
- 中の人が投稿しているトピックなどもある
  - 例： Event Orchestration についての投稿
    - Best Practices for Event Orchestration - 🎧 Support - Friends of Pagey
    - Event Orchestration Q&A with Frank Emery - 🎟 Events & Meetups - Friends of Pagey
Blog - PagerDuty
- リリース情報やベストプラクティスなど
Pricing | PagerDuty
- プラン別機能一覧

内容は充実していますが、情報が散らばっている印象です。

イベントフロー

各機能の流れと関係はこのようになると思います。

f:id:htnosm:20220415055709p:plain

対象外とした機能

App

Developer Mode にした上で利用する形となるため、今回は除外しています。

Developer Platform の "Build App & Integration" 辺りにドキュメントがあります。
Custom Event Transformer Integration のように、 JavaScript による Event Transformer 機能を持っており、各 Service 配下の Integration 設定で行っていたスクリプトを1箇所で管理するなどができるようです。

Service Rule

今後は後継の Service Orchestration に置き換わっていくと思われるため、今回は除外しています。

各 PagerDuty Service に振り分けされたイベントを操作する際に使用します。 (Service Event Rules)

設定画面上も、 Switch to Service Orchestrations ボタンがあり、今後は Service Orchestration 機能に移行していく事が推奨されているようです。ドキュメントにも記載があります。(Switch to Service Orchestrations )

選択肢

どの機能を使用するかの判断はこのようになると思います。

f:id:htnosm:20220415055713p:plain

Service か Global か

f:id:htnosm:20220415055717p:plain

Service 配下の方が小回りが効きます。管理外のシステムから他社に連携してもらう場合など、固有Endpointの方が向いているでしょう。

Global は一箇所でまとめて管理できるメリットがありますが、権限やプランの関係で利用できない可能性があります。

Orchestration か Rulesets かという点は、特に支障が無ければ Orchestration が推奨されると思います。使ってみた限りでは Rulesets にできて Orchestration にできないことはありませんでした。

Service の Endpoint

f:id:htnosm:20220415055721p:plain

Service の場合、提供されているなら Integration が使いやすいと思います。

htnosm.hatenablog.com

Custom Event Transfer は自前で Integration を作成するイメージで、JavaScript を書く必要がありますが自由度は高いです。

htnosm.hatenablog.com

API 実行で送信を行う場合は Events API v2 インテグレーションを利用します。

htnosm.hatenablog.com

Email しか送信手段が無ければ Email Integration になりますが、細かな制御はできません。抽出・変換は後述 Service Orchestration で行う形になります。

htnosm.hatenablog.com

Global の Endpoint

f:id:htnosm:20220415055726p:plain

Global の場合、 PD-CEF に対応していれば Integration URL へそのまま送信できます。

Global Orchestration
- htnosm.hatenablog.com
- htnosm.hatenablog.com
Global Rulesets
- htnosm.hatenablog.com
- htnosm.hatenablog.com

非対応形式の場合は HTTP endpoint か Email となります。 HTTP endpoint へは API を実行して送信します。

htnosm.hatenablog.com

Email は、Email Integration 同様、抽出・変換は後述 Service Orchestration で行う形になります。

Global Orchestration
- htnosm.hatenablog.com
Global Rulesets
- htnosm.hatenablog.com

ルーティング後の操作

f:id:htnosm:20220415055731p:plain

Service Orchestration にて実施します。 Service にルーティングされたイベントに対して実行できます。 Global Orchestration 経由である必要はありません。参考例としては、前述の Global Orchestration の記事内 Transformations で使用しています。

コード化

各種APIが提供されているのでコード管理も可能です。

Terraformの PagerDutyプロバイダが提供されているので利用しています。

Terraform 未サポートリソース

いずれも PagerDuty API は提供されていますが、検証時点では Terraform (PagerDuty Provider) ではサポートしていませんでした。

Event Orchestration
- Add support for event_orchestrations API · Issue #465 · PagerDuty/terraform-provider-pagerduty
各 Service Integration の詳細設定
- Add email_filters to pagerduty_service_integration of type generic_email_inbound_integration · Issue #88 · PagerDuty/terraform-provider-pagerduty · GitHub
- Email Fileter は v2.4.0 で追加されました
  - resource/pagerduty_service_integration: Add Email Filters to Service Integrations (#468)

まとめのまとめ

これまで Integration を利用することが多かったのですが、新機能の Orchestration が発表されたことで改めて手法を確認し、様々な連携方法があることを知りました。各種Webサービスのイベント連携は何かしらで行えそうです。

ノーコードでルール設定できる Orchestration は利用頻度が上がりそうです。特に、受信した内容をそのままルールの条件値として使用できる raw_event が使えるのは良いと思います。

今回の検証した結果の記事一覧は以下になります。

htnosm.hatenablog.com

今回試した AWS と PagerDuty の連携例をコード(Terraform)化した物は以下に置いています。

htnosm/example-aws-to-pd: Example of notification from AWS to PD

2022-04-17

AWS から PagerDuty への通知連携(11)

AWS PagerDuty

Event API v2

番外編です。
APIを直接実行する事で、任意のイベントを送信できます。

PagerDuty DEVELOPER PLATFORM
- Events API v2 -> Sending an Alert Event -> Send an Alert Event

Global Orchestration、Global Ruleset、Service それぞれに対して送信できます。

Event API v2

導入

受信側(PagerDuty)

利用する機能の Integration Key を取得します。 Endpoint は同一の https://events.pagerduty.com/v2/enqueue です。

Global Orchestration の場合

f:id:htnosm:20220415053833p:plain

適宜 Routing Rule と Action Rule を追加します。例として、送信側で source に TopicArn を設定するようにし、判別できるようにしています。

f:id:htnosm:20220415053837p:plain

Global Rulesets の場合

f:id:htnosm:20220415053841p:plain

適宜 Event Rule を追加します。例として、送信側で source に TopicArn を設定するようにし、判別できるようにしています。

Service の場合

"Events API v2" インテグレーションを使用します。 DEVELOPER PLATFORM の "Events API v2 Overview" に設定方法が記載されています。

f:id:htnosm:20220415053850p:plain

指定できるオプションはありません。

f:id:htnosm:20220415053855p:plain

送信側(AWS)

API Reference を参考に送信処理を実装します。

API References
- PagerDuty V2 Events API -> Send Event -> Send an event to PagerDuty

Python の場合、標準ライブラリとRequests利用の2パターン例示されています。

import http.client
conn = http.client.HTTPSConnection("events.pagerduty.com")
payload = "{...}"
headers = { 'Content-Type': "application/json" }

conn.request("POST", "/v2/enqueue", payload, headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))

今回は SNS -> Lambda Function で連携します。

SNS Topic Subscription
Lambda Function

API Limits

DEVELOPER PLATFORM の "Events API v2 Overview" に記載されています。

Rate Limits の制限値は明記されていません。制限超過した場合、 StatusCode: 429 (Too Many Requests) を返却するので、必要に応じてリトライを実施しなさいとのことです。

Size Limits は 512 KB です。

インシデント

API実行時に指定した $payload.summary 、$.payload.custom_details でインシデントが作成されます。

f:id:htnosm:20220415053909p:plain

重複排除

$payload.dedup_key で指定します。

2022-04-15

AWS から PagerDuty への通知連携(10)

AWS PagerDuty

EventBridge -> Global Orchestration (Email)

Global Ruleset および Global Orchestration は Email Address を持っています。

EventBridge -> Global Orchestration (Email)

導入

SNS Subscription では Email または Email-JSON で送信できるので、2パターン試します。

AWS SNS の Subscription に Global Orchestration の "Email Address" を Protocol "Email" または "Email-JSON" として指定します。

f:id:htnosm:20220410133821p:plain

"AWS Notification - Subscription Confirmation" の件名でAlertが作成されるので、confirm を実施することで利用できるようになります。(ルールに合致しない状態ではインシデントは作成されません。)

この際、同一件名で Alert が Triggered (Suppressed) の状態だとAlertも新規発行されず追加となります。新規発行としたい場合はAlertもResolve(Resolve(Suppressed) の状態)にしておく必要があります。

ルール(ルーティングルール)

利用できるfieldは以下になります。

> - event.custom_details.from[0](the from address)
>> * The [0] refers to the 1st position in a list of emails. If you would like to generally search through a list of emails (either in the "to" field or the "from" field), please set to event.custom_details.from or event.custom_details.to.
>
> - event.custom_details.subject (the subject line)
> - event.custom_details.plain_body (the email body)

TopicArn の形式などで Email, Email-JSON の判別もできます。

f:id:htnosm:20220410133825p:plain

# Email
`event.custom_details.subject` matches `AWS Notification Message`
and
`event.custom_details.plain_body` matches part `?SubscriptionArn=arn:aws:sns:ap-northeast-1:123456789012:example-aws-to-pd-eventbridge:`

# Email-JSON
`event.custom_details.subject` matches `AWS Notification Message`
and
`event.custom_details.plain_body` matches part `"TopicArn" : "arn:aws:sns:ap-northeast-1:123456789012:example-aws-to-pd-eventbridge"`

インシデント

初期状態でのインシデントタイトルはメール件名で作成されます。

AWS Notification Message

詳細欄はメール本文です。 Email は Message の内容のみとなるので、 Email-JSON の方が若干情報量が多いです。

重複排除

Ruleの "Transformations" から変更します。

Transformations (サービスルール)

Transformationsを参考に出力内容を調整します。

Summary を TopicName と detail-type に変換、また、都度インシデントを作成するため dedep_key に MessageId を設定します。
Message は JSON 文字列 となっているので正規表現で抜き出します。

f:id:htnosm:20220410133829p:plain

Email

Define Custom Variable

Name	Regex	Source
topic_name	`^.SubscriptionArn=(?:[^:]:){5}([^:]):.$`	event.custom_details.plain_body
detail_type	`^."detail-type":"([^"])".*$`	event.custom_details.plain_body
message_id	`^."id":"([^"])".*$`	event.custom_details.plain_body

Replace Event Field

Event Field (CEF)	Value
summary	`Email [{{variables.topic_name}}] {{variables.detail_type}}`
dedup_key	`{{variables.message_id}}`

Email-JSON

Define Custom Variable

Name	Regex	Source
topic_name	`^."TopicArn" : "(?:[^:]:){5}([^"])".$`	event.custom_details.plain_body
detail_type	`^."Message" : "."detail-type\\":\\"([^\\])\\".$`	event.custom_details.plain_body
message_id	`^."MessageId" : "([^"])".*$`	event.custom_details.plain_body

Replace Event Field

Event Field (CEF)	Value
summary	`Email-JSON [{{variables.topic_name}}] {{variables.detail_type}}`
dedup_key	`{{variables.message_id}}`

インシデント(変換後)

Summary が変換されたことを確認できます。
dedup_key を指定したことにより、インシデントがTriggeredの状態で残っている状態で再度同一イベントが発生した場合にも、インシデントが作成されます。

Email
Email-JSON

2022-04-13

AWS から PagerDuty への通知連携(9)

AWS PagerDuty

EventBridge -> Gloal Ruleset (Email)

Global Ruleset および Global Orchestration は Email Address を持っています。

EventBridge -> Gloal Ruleset (Email)

導入

SNS Subscription では Email または Email-JSON で送信できるので、2パターン試します。

AWS SNS の Subscription に Global Ruleset の "Email Address" を Protocol "Email" または "Email-JSON" として指定します。

f:id:htnosm:20220410113336p:plain

f:id:htnosm:20220410113340p:plain

View Message からイベント内の Confirm URL を確認できます。

Email
Email-JSON

ルール (conditions)

利用できるfieldは以下になります。

> - headers.from.0.address (the from address)
>> * Note: .0.address refers to the 1st position in a list of emails. If you would like to generally search through a list of emails (either in the "to" field or the "from" field), please set to headers.from or headers.to
>
> - headers.subject (the subject line)
> - body (the email body)

TopicArn の形式などで Email, Email-JSON の判別もできます。

f:id:htnosm:20220410113353p:plain

# Email
When all conditions are met

`headers.subject`  equals  `AWS Notification Message`
`body`  contains  `?SubscriptionArn=arn:aws:sns:ap-northeast-1:123456789012:example-aws-to-pd-eventbridge:`

# Email-JSON
When all conditions are met

`headers.subject`  equals  `AWS Notification Message`
`body`  contains  `"TopicArn" : "arn:aws:sns:ap-northeast-1:123456789012:example-aws-to-pd-eventbridge"`