Content last updated 2026-07-14

Audit Events Analyzer

Audit Events Analyzer のドキュメント

このガイドでは、Zendesk で使用するために私たちが作成したカスタム設定、Audit Events Analyzer について説明します。

Audit Events Analyzer を理解する

Audit Events Analyzer とは

Audit Events Analyzer は、特定の種類の監査イベントを分析し、それに応じて Customer Support Systems チームへ通知する Zendesk Webhook と CI/CD スクリプトの組み合わせです。

Audit Events Analyzer の仕組み

Zendesk User events Webhookを使用して、対応するプロジェクト内で、Webhook が送信したペイロードにより CI/CD パイプラインがトリガーされます。プロジェクトは Zendesk インスタンスに基づいて決まります。現在監視するユーザーイベントは次のとおりです。

  • Support ユーザーロールの変更

CI/CD パイプラインが作成されると、bin/analyze スクリプトが実行され、次を行います。

  • イベントがロールのダウングレードか確認する(新しいロールが end-user、または adminagent に変更された場合)
    • 該当する場合、ステータスコード 0 で終了する
  • イベントが light agent のアップグレードか確認する(前のロールが end-user、新しいロールが agent、メールアドレスが @gitlab.com で終わる場合)
    • 該当する場合、ステータスコード 0 で終了する
  • アップグレードされたユーザーの前のロールが end-user の場合、@channel タグを使用して Slack に投稿する
  • アップグレードされたユーザーの前のロールが agent の場合、@here タグを使用して Slack に投稿する

管理者のタスク

Audit Events Analyzer プロジェクトの変更

Audit Events Analyzer プロジェクトを変更するには、プロジェクトリポジトリで MR を作成する必要があります。正確にどの変更を行うかは、リクエスト自体によって決まります。

同僚が MR をレビューして承認した後、MR をマージできます。これは Ad-hoc デプロイタイプであるため、変更は直ちに反映されます。

Webhook の変更

Webhook を変更する方法については、Webhooksに関するドキュメントを参照してください。

よくある問題とトラブルシューティング

これは必要に応じて項目を追加する、生きたセクションです。