Talend JobServer用に監視および監査システムを設定

Talend JobServerで実行された主な操作を記録するための監査ログシステムを設定します。

さらに、開発環境でジョブサーバーを使用する時に、統計やトレースメッセージの転送システムを設定することもできます。

Talend JobServerの監査ログを設定

Talend JobServerバージョン8.0.2.20250110_1323_patch (zipファイル名: Patch_20250114_TPS-6002_v4-8.0.1)以降では、監査ロギングを有効にすれば、クライアントアプリケーション(Talend StudioやTalend Administration Centerなど)によってトリガーされた操作を追跡できます。

それによって、重要なアクティビティの監視と監査が可能になります。監査ログでは次の操作が記録されます:

ジョブの取得
ジョブのデプロイ
ジョブの実行
実行中であるジョブの中止
ユーザーが操作を許可されているかどうかの確認
デプロイメント前にエラーが発生した場合に有効なCRC (巡回冗長検査)を取得

このタスクについて

監査ログ用のロガーは、log4j2.xmlファイルに事前設定されています:

<Logger name="org.talend.audit" level="info" additivity="false">
   <AppenderRef ref="Audit"/>
</Logger>

この手順では以下が表示されます:

監査ログを有効または無効にする方法
このロガーが使用する監査アペンダーをアップデートし、監査ログの保存を指定する方法

手順

<jobserver_path>/conf/TalendJobServer.properties ファイルのorg.talend.remote.jobserver.commons.config.JobServerConfiguration.AUDIT_LOG_LEVELプロパティを使って、監査ログを有効または無効にします。
使用する値は次のとおりです:
- 0 (監査ログを無効にする場合)
- 1 (監査ログを有効にする場合)

監査ログを専用のファイルに書き込むか、他のログに含めるかを設定します。

推奨: 監査ログを特定のファイルパターンで別のファイルに書き込む場合は、log4j2.xmlファイルで、Auditと呼ばれるRollingFileアペンダーのfileName属性とfilePattern属性をアップデートします。例:
```
<RollingFile name="Audit" fileName="jobserver_audit.log"
   filePattern="jobserver_audit-%d{MM-dd-yyyy}.log.gz" ignoreExceptions="false">
      
</RollingFile>
```
この設定の場合、Talend JobServerは、指定されたファイルjobserver_audit.logに監査ログを書き込みます。

監査ログを他のログと一緒にjobserver.logに含める場合は、Auditアペンダーのデフォルト設定を維持します。デフォルト設定は次のようになります:

<RollingFile name="A1" fileName="jobserver.log" filePattern="jobserver-%d{MM-dd-yyyy}.log.gz"
  ignoreExceptions="false">
    <!-- skipped for brevity -->
</RollingFile>

<RollingFile name="Audit" fileName="jobserver.log" filePattern="jobserver-%d{MM-dd-yyyy}.log.gz"
 ignoreExceptions="false">
   <PatternLayout pattern="%d %-5p %c{1} 
   - %m%n %X{userId,jobId,utcTime,jobServerId,clientIP,projectId,failed}%n"/>
   <ThresholdFilter level="INFO" onMatch="ACCEPT" onMismatch="DENY"/>
   <Policies>
      <SizeBasedTriggeringPolicy size="1000KB"/>
   </Policies>
   <DefaultRolloverStrategy max="100"/>
</RollingFile>

タスクの結果

監査ログは、デフォルトで%X{userId,jobId,utcTime,jobServerId,clientIP,projectId,failed}というMDC形式を使用します。

MDCフィールドを取得して、カスタムログレイアウト(名前付きフィールドを持つJSONなど)を作成できます。

開発環境用に統計とトレースメッセージの転送を設定

リモートで実行されるジョブについて、Talend Studioが最新の統計とトレースメッセージをTalend JobServerからフェッチする際のポートを指定できます。

About this task

統計とトレースメッセージ機能は開発環境のためのものです。

本番環境では、統計とトレースメッセージの転送をオフにしてください。これにより、メモリの過剰使用が回避され、ネットワーク接続が適切に保護されていない場合も外部からの接続から保護できるようになります。

リアルタイム統計を使用すると、JobServer側で過剰にメモリが使用されることがあります。ZeroMQ関連のメモリリークが発生した場合、Talend Administration Centerでのリアルタイム統計は利用できなくなりますが、JobServer の統計とトレースメッセージをオフにしてください。

Procedure

<root>/conf/に移動し(<root>はTalend JobServerパス)、TalendJobServer.propertiesを開いて編集します。
メッセージ転送用のポートを指定する場合は、次のように設定します:
```
org.talend.remote.jobserver.server.TalendJobServer.PROCESS_MESSAGE_PORT=<port_number>
```
デフォルトのポートは8555だが、利用可能なポートを使用できます。
統計とトレースメッセージの転送をオンにするには、以下のパラメーターをtrueに設定します。
```
org.talend.remote.jobserver.server.TalendJobServer.ENABLED_PROCESS_MESSAGE=true
```
変更を保存してTalend JobServerを再起動すると、設定が有効になります。

Results

転送システムで作業する際は、Talend StudioとTalend Administration Centerで統計機能をオンにします:

統計の表示をご覧ください。
Collecting Job execution statisticsをご覧ください。

上述したように、パフォーマンスとセキュリティ上の理由から、統計は開発環境でのみオンにしてください。本番環境では、Talend StudioとTalend Administration Centerの両方で統計機能をオフにしてください。

このページは役に立ちましたか?

このページまたはコンテンツにタイポ、ステップの省略、技術的エラーなどの問題が見つかった場合はお知らせください。

こちらにフィードバックをお寄せください