サーバーへのログ アクション

サーバーへのログ アクションは API タスク のためにネイティブにロギング機能を導入します。 このアクションにより、カスタムログを作成し、API タスク ランタイムログと共に Control Room に設定された任意のセキュリティ情報およびイベント管理 (SIEM) サーバーに転送できます。

概要

サーバーへのログは、ログを SIEM サーバーに転送することでAPI タスクのランタイムログを確認できるようにします。 カスタムログを作成し、ランタイムログと一緒に転送することもできます。 以前、API タスク はファイル処理能力の制限によりログの転送を許可していませんでした。

SIEM サーバーへのログの転送は、オートメーションの実行中に発生する可能性のあるエラーをデバッグし、オートメーションの実行時データを検証するための集中管理された手段を提供します。 SIEM サーバーで利用可能なツールの報告および分析機能を活用して、ログを分析および管理することができます。 組織の要件に従って、コンプライアンスおよび規制監査のためにサーバーにログを保持することもできます。

SIEM の統合設定を構成してから、自動化で サーバーへのログ アクションを使用するようにしてください。 SIEM 統合設定の構成に関する詳細については、SIEM との統合を設定 を参照してください。

転送されたカスタムログには、以下のパラメーターが含まれます。
パラメーター 説明
logMessage ログメッセージにはログコンテンツのログヘッダーが含まれています。
executionId オートメーションの実行 ID。 実行 ID は、オートメーションの アクティビティ ページを開くときに URL に表示されます。
logLevel アクションを設定する際に設定したログレベル。
sysLogSource アクションを設定する際に設定したデータソースタグ。 このタグはログの識別子として機能します。
botName 自動化を作成する際に入力した名前。
botId オートメーションの Bot ID。 Bot ID は、Bot エディター ワークスペースで Bot を開くときに URL に表示されます。
logCreatedTime オートメーションを作成した時刻。 このエントリーには日付と時間が含まれています。

設定

  • 記録するテキスト: ログヘッダーの名前を入力します。 logMessage パラメータはログヘッダーを表示します。 最大許容テキスト長は1024文字です。
  • 自動化で設定された変数の情報は、ログに記録する変数 オプションを使用してエクスポートできます。 サーバーへのログアクションは、文字列、数値、日時、ブール変数をサポートしています。 変数とそれぞれのデフォルト値は、logMessage パラメータにも表示されます。

    次のいずれかを選択してください。

    • タイプ別: このオプションを使用して、タイプに基づいて変数をログします。 変数を個別にまたは一緒にログできます。
      注: タイプ別 オプションを選択すると、変数をファイルに記録 アクションを追加した後に、後で作成した変数もログに記録できます。
    • カスタム選択: このオプションを使用して、変数を個別にまたは一緒に選択してログに記録します。
  • データソースタグ (任意): 識別のためのタグをログエントリに追加します。 タグは SIEM サーバー内のログを簡単にフィルタリングできるようにします。 データソースタグは sysLogSource パラメータに表示されます。
  • ログ レベル: 要件に基づいてログ情報の適切なレベルを選択してください。 ログレベルは logLevel パラメータに表示されます。 以下のログレベルを利用できます:
    • 緊急事態
    • エラー
    • 警告
    • 情報
    • デバッグ

トラブルシューティング

サーバーへのログ アクションは API タスク でのみ利用でき、タスク Bot では利用できません。

サーバーへのログを含むAPI タスクをテストするには、API タスク編集ページで利用可能なデバッグオプションを使用すると、次のエラーが表示されます: Bot のデプロイで予期せぬエラーが発生しました。 このエラーは、互換性のないエージェントターゲットが原因で発生します。 デバッグ中、API タスク はローカルの Bot 実行者上で実行され、Windows または macOS のBot エージェントを探します。 サーバーへのログ アクションのエージェントターゲットはヘッドレスです。 このエージェントのターゲットの不一致が非互換性を引き起こします。

自動化をテストするには、自動化を保存し、API タスクを実行オプションを使用して実行します。これはPrivateリポジトリページの省略記号メニューにあります。