HaloITSM連携

本ページは機械翻訳をもとに提供しています。正確かつ最新の情報は 英語版の内容をご参照ください。

HaloITSMは、インシデント、サービス要求、その他のITサービス管理を支援するプラットフォームです。

HaloITSMとの連携により、監視アラートをチケットとしてHaloITSMアカウントへ自動転送できます。監視リソースのステータスが変化すると、HaloITSMでチケットが作成/更新されるため、ITサービス管理ワークフローをインフラのリアルタイムな稼働状況に合わせて運用できます。

連携の主な機能

この連携では、以下の機能を利用できます。

  • 監視アラートをチケットとしてHaloITSMアカウントへ直接転送できます。
  • 監視ステータスの変化(Down、Trouble、Critical、Problem)を条件にチケット作成をトリガーし、その後のステータス更新を対応するチケットへコメントとして自動追加できます。
  • $MONITORNAMEや$STATUSなどの動的変数でチケットの件名をカスタマイズでき、通知テンプレートを使ってHaloITSMへ送信するアラート情報も調整できます。
  • 関連付けられたHaloITSMチケットの詳細を[アラーム詳細]ページから直接確認できます。
  • 連携に失敗した場合に、適切なユーザーグループへ通知できます。

前提条件

HaloITSMと連携する前に、以下の条件を満たしていることを確認してください。

  • 有効なHaloITSMアカウントとインスタンスURLがあること。
  • チケット管理に必要な権限を持つアプリケーションをHaloITSMで作成してあること。
  • APIキー認証の場合はAPI Key、OAuth認証の場合はClient IDとClient SecretをHaloITSMから取得してあること。

HaloITSM側の設定

  1. HaloITSMアカウントにログインします。
  2. [Configuration]→[Integrations]→[Halo API]へ移動します。
  3. [New Application]をクリックして新しいアプリケーションを作成します。
  4. [Application Name]に識別しやすい名前(例:Site24x7連携)を入力します。
  5. [Authentication Method]で、次のいずれかを設定します。
    • API Key(APIキー認証):
      • [API Key]を選択します。チケット管理に必要な権限(create、read、update)をアプリケーションへ付与します。
      • アプリケーションを[Save]します。HaloITSMでAPI Keyが生成されます。
        後の連携用の認証プロファイル設定時に必要となるため、API Keyをコピーして保存しておきます。
    • OAuth認証:
      • [Authorisation Code (Native Application)]を選択します。
      • チケット管理に必要な権限(create、read、update)を設定します。
      • [Save]をクリックします。HaloITSMで[Client ID]と[Client Secret]が生成されます。
        後の連携用の認証プロファイル設定時に必要となるため、Client IDとClient Secretをコピーして保存しておきます。
  6. HaloITSMインスタンスURL(例:https://your-subdomain.haloservicedesk.com)をコピーします。連携設定時に必要です。
API Key、Client ID、Client Secretは、第三者と共有しないようご注意ください。

Site24x7側の設定

  1. Site24x7にログインします。
  2. [管理]→[3rdパーティ連携]→[HaloITSM]へ移動します。
  3. 連携フォームで以下を設定します。
    • 連携名:連携名を入力します。
    • 連携URL:HaloITSMインスタンスのベースURLを入力します。(例:https://your-subdomain.haloservicedesk.com)
    • 認証方式:使用する認証方式を選択し、認証情報を設定します。
      • 認証情報プロファイル:連携に必要な認証情報(APIアクセストークンなど)を安全に保存・管理するため、既存の認証情報プロファイルをドロップダウンから選択します。
        認証情報プロファイルを使用することで、認証情報を公開せずにアプリケーション内で安全に再利用できます。
        未作成の場合は[+]をクリックして新しい認証情報プロファイルを追加してください。
      • OAuth:OAuth認証情報を設定します。構成済みのOAuthから既存の[プロバイダー名]を選択するか、[+]をクリックして新規追加します。OAuthプロバイダー作成時はOAuth FlowにClient Credentialsを選択し、HaloITSMから取得したClient IDとClient Secretを入力します。 
    • メッセージの件名:HaloITSMチケットのタイトルを入力します。[$]を入力すると、利用可能なインシデントパラメーターを選択して動的にタイトルへ反映できます。
      例:$MONITORNAME が $STATUSです。
    • 監視のステータス変更があった時にアラートをトリガー:HaloITSMでチケットを作成または更新する監視ステータスの変化を選択します。選択可能なステータスは[ダウン][トラブル][クリティカル][問題]です。1つ以上選択してください。
    • 私の監視ステータスがアップになった時に手動でインシデントをクローズ:Site24x7の監視ステータスが[アップ]に変わった際、HaloITSM側のインシデントを手動でクローズするか自動でクローズするかをトグルで設定します。デフォルトではHaloITSMが自動でクローズします。
    • 連携レベルの選択:HaloITSMへアラート送信する対象リソースを選択します。利用可能なオプションは次のとおりです。
      • 監視:HaloITSMへアラート送信する特定の監視を選択します。
      • タグ:指定したタグに関連するアラートを送信します。
      • 監視グループ:指定した監視グループ内の監視からアラートを送信します。
      • すべての監視:アカウント内のすべての監視からアラートを送信します。
    • アラートで送信されるタグ:HaloITSMへ送信するアラートに含める監視タグキーを選択します。タグを選択しない場合、適用可能な監視タグがすべてアラートに含まれます。
    • HaloITSM連携の横に
    • 代替通知手段:プライマリのHaloITSM連携で問題が発生した場合に使用する代替通知手段を選択します。
    • ユーザーアラートグループ:HaloITSM連携に失敗した際に通知するユーザーアラートグループを選択します。これにより、適切なチームが連携の障害を把握し、トラブルシュートできます。
      カスタムパラメーター(英語版)は、通知テンプレートでサポートされています。テンプレートでパラメーターを設定すると、連携へ送信するアラートに含めることができます。
  4. [保存してテスト]をクリックすると、連携を保存してテストアラートを送信します。テスト送信せずに設定を完了する場合は[保存]をクリックします。

設定が完了すると、HaloITSM連携は[3rdパーティ連携]ダッシュボードに表示されます。

通知テンプレートによるアラートのカスタマイズ

[通知テンプレート]を使用して、HaloITSMへ送信するアラート情報をカスタマイズできます。通知テンプレートでは、要件に応じてアラートの内容と形式を定義できます。

通知テンプレートの追加と設定については、通知テンプレートを参照してください。

設定後、HaloITSMへ送信されるアラートは、選択した通知テンプレートで定義したカスタム形式で表示されます。

HaloITSM連携のテスト

連携設定後にテストアラートを送信して、本プラットフォームとHaloITSM間の接続を確認できます。

  1. [管理]→[3rdパーティ連携]へ移動します。
  2. 設定済みのHaloITSM連携を選択します。
  3. [テストアラートをトリガー]アイコンをクリックし、HaloITSMで対応するチケットが正常に作成されることを確認します。

テストに失敗する場合は、インスタンスURL、OAuthプロバイダー設定、APIアプリケーション権限、HaloITSM認証情報を確認してください。

HaloITSM連携の一時停止/有効化/削除

連携の一時停止/有効化/削除は以下の手順で実行します。

一時停止

  1. アカウントでログインします。
  2. [管理]→[3rdパーティ連携]へ移動します。
  3. HaloITSM連携の横にあるハンバーガーアイコン「≡」をクリックします。
  4. [一時停止]を選択します。

これにより、HaloITSMアカウントへのアラート通知送信が停止します。

有効化

  1. アカウントでログインします。
  2. [管理]→[3rdパーティ連携]へ移動します。
  3. HaloITSM連携の横にあるハンバーガーアイコン「≡」をクリックします。
  4. [アクティベート]を選択します。

これにより、HaloITSMアカウントへのアラート通知送信が再開されます。

削除

  1. アカウントでログインします。
  2. [管理]→[3rdパーティ連携]へ移動します。
  3. HaloITSM連携の横にあるハンバーガーアイコン「≡」をクリックします。
  4. [削除]を選択します。

これにより、HaloITSM連携はアカウントから完全に削除されます。この操作は元に戻せません。

閉ループ連携プロセス

閉ループ連携プロセス(CLIP)の一環として、ITSMインシデントテンプレートの詳細が製品の[Events]ページに直接表示され、関連するインシデント情報へすばやくアクセスできます。