All Skills > Feature Setup > Create Alert

Sentry アラート作成

Sentry の workflow engine API を通じてアラートを作成します。

注記: この API は現在 ベータ版 であり、変更される可能性があります。新しいモニタリングとアラート機能の一部であり、レガシーアラート UI では表示されない可能性があります。

このスキルを呼び出す場合

• ユーザーが「Sentry アラートを作成する」または「通知を設定する」と要求した場合
• ユーザーが特定の条件に一致する問題について、メール送信または通知を希望する場合
• ユーザーが優先度アラート、エスカレーション解除アラート、または workflow 自動化について言及した場合
• ユーザーが Sentry 問題用に Slack、PagerDuty、またはメール通知を設定したい場合

前提条件

• シェルで curl が利用可能
• alerts:write スコープを持つ Sentry org 認証トークン (org:admin または org:write も可)

フェーズ 1: 構成情報を収集

不足している詳細についてユーザーに確認します:

詳細	必須	例
Org slug	はい	sentry, my-org
Auth token	はい	sntryu_... (alerts:write スコープが必要)
Region	はい (デフォルト: us)	us → us.sentry.io, de → de.sentry.io
Alert 名	はい	"High Priority De-escalation Alert"
トリガーイベント	はい	どの問題イベントが workflow を起動するか
Conditions	オプション	アクション実行前にフィルタリングする条件
Action type	はい	email, slack, または pagerduty
Action target	はい	ユーザーメール、チーム、チャネル、またはサービス

フェーズ 2: ID を検索

必要に応じて、名前を ID に解決するために以下の API 呼び出しを使用します。

API="https://{region}.sentry.io/api/0/organizations/{org}"
AUTH="Authorization: Bearer {token}"

# メールでユーザー ID を検索
curl -s "$API/members/" -H "$AUTH" | python3 -c "
import json,sys
for m in json.load(sys.stdin):
  if m.get('email')=='USER_EMAIL' or m.get('user',{}).get('email')=='USER_EMAIL':
    print(m['user']['id']); break"

# チームをリストアップ
curl -s "$API/teams/" -H "$AUTH" | python3 -c "
import json,sys
for t in json.load(sys.stdin):
  print(t['id'], t['slug'])"

# インテグレーションをリストアップ (Slack/PagerDuty 用)
curl -s "$API/integrations/" -H "$AUTH" | python3 -c "
import json,sys
for i in json.load(sys.stdin):
  print(i['id'], i['provider']['key'], i['name'])"

フェーズ 3: ペイロードを構築

トリガーイベント

workflow を起動する問題イベントを選択します。常に logicType: "any-short" を使用します (トリガーは常にこれを使用する必要があります)。

型	起動する条件
first_seen_event	新しい問題が作成された
regression_event	解決済みの問題が再発した
reappeared_event	アーカイブされた問題が再度表示された
issue_resolved_trigger	問題が解決された

フィルタ条件

アクション実行前に満たす必要のある条件。logicType: "all", "any-short", または "none" を使用します。

comparison フィールドはポリモーフィック — その形状は条件の type に依存します:

型	comparison 形式	説明
issue_priority_greater_or_equal	75 (単純な整数)	優先度 >= Low(25)/Medium(50)/High(75)
issue_priority_deescalating	true (単純なブール値)	優先度がピークを下回った
event_frequency_count	{"value": 100, "interval": "1hr"}	時間枠内のイベント数
event_unique_user_frequency_count	{"value": 50, "interval": "1hr"}	時間枠内で影響を受けたユーザー数
tagged_event	{"key": "level", "match": "eq", "value": "error"}	イベントタグが一致
assigned_to	{"targetType": "Member", "targetIdentifier": 123}	問題が対象に割り当てられた
level	{"level": 40, "match": "gte"}	イベントレベル (fatal=50, error=40, warning=30)
age_comparison	{"time": "hour", "value": 24, "comparisonType": "older"}	問題の経過時間
issue_category	{"value": 1}	カテゴリ (1=Error, 6=Feedback)
issue_occurrences	{"value": 100}	総発生件数

インターバルオプション: "1min", "5min", "15min", "1hr", "1d", "1w", "30d"

タグマッチタイプ: "co" (含む), "nc" (含まない), "eq", "ne", "sw" (で始まる), "ew" (で終わる), "is" (設定済み), "ns" (未設定)

conditionResult を false に設定して反転させます (条件が満たされないときに起動)。

アクション

型	キー構成
email	config.targetType: "user" / "team" / "issue_owners", config.targetIdentifier: <id>
slack	integrationId: <id>, config.targetDisplay: "#channel-name"
pagerduty	integrationId: <id>, config.targetDisplay: <service_name>, data.priority: "critical"
discord	integrationId: <id>, data.tags: タグリスト
msteams	integrationId: <id>, config.targetDisplay: <channel>
opsgenie	integrationId: <id>, data.priority: "P1"-"P5"
jira	integrationId: <id>, data: プロジェクト/イシュー構成
github	integrationId: <id>, data: リポジトリ/イシュー構成

完全なペイロード構造

{
  "name": "<Alert Name>",
  "enabled": true,
  "environment": null,
  "config": { "frequency": 30 },
  "triggers": {
    "logicType": "any-short",
    "conditions": [
      { "type": "first_seen_event", "comparison": true, "conditionResult": true }
    ],
    "actions": []
  },
  "actionFilters": [{
    "logicType": "all",
    "conditions": [
      { "type": "issue_priority_greater_or_equal", "comparison": 75, "conditionResult": true },
      { "type": "event_frequency_count", "comparison": {"value": 50, "interval": "1hr"}, "conditionResult": true }
    ],
    "actions": [{
      "type": "email",
      "integrationId": null,
      "data": {},
      "config": {
        "targetType": "user",
        "targetIdentifier": "<user_id>",
        "targetDisplay": null
      },
      "status": "active"
    }]
  }]
}

frequency: 繰り返し通知の間隔 (分単位)。許可される値: 0, 5, 10, 30, 60, 180, 720, 1440。

構造上の注記: triggers.actions は常に [] です — アクションは actionFilters[].actions 内に存在します。

フェーズ 4: アラートを作成

curl -s -w "\n%{http_code}" -X POST \
  "https://{region}.sentry.io/api/0/organizations/{org}/workflows/" \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json" \
  -d '{payload}'

HTTP 201 が返されることを想定しています。レスポンスには workflow id が含まれます。

フェーズ 5: 確認

アラートが作成されたことを確認して、UI リンクを提供します:

https://{org_slug}.sentry.io/monitors/alerts/{workflow_id}/

Org に workflow-engine-ui フィーチャーフラグがない場合、アラートは以下に表示されます:

https://{org_slug}.sentry.io/alerts/rules/

アラートを管理

# すべての workflow をリストアップ
curl -s "$API/workflows/" -H "$AUTH"

# 1 つの workflow を取得
curl -s "$API/workflows/{id}/" -H "$AUTH"

# workflow を更新
curl -s -X PUT "$API/workflows/{id}/" -H "$AUTH" -H "Content-Type: application/json" -d '{payload}'

# workflow を削除
curl -s -X DELETE "$API/workflows/{id}/" -H "$AUTH"
# 204 が返されることを想定

トラブルシューティング

問題	解決方法
401 Unauthorized	トークンに alerts:write スコープが必要です
403 Forbidden	トークンは対象 org に属している必要があります
404 Not Found	Org slug とリージョン (us vs de) を確認します
400 Bad Request	ペイロード JSON 構造を検証し、必須フィールドを確認します
ユーザー ID が見つからない	メールが org のメンバーと一致することを確認します