Voice Gateway のロギングおよびトレースの構成

ロギングおよびトレースのレベルは、Voice Gateway の他の構成と同様に、Docker 環境変数として構成します (Voice Gateway の構成環境変数の説明を参照)。 ログに書き込まれるメッセージについて詳しくは、Voice Gateway のシステム・メッセージを参照してください。

• デフォルトのログおよびトレース構成の変更
• ログ・ファイル言語の設定
• ログ・ファイルのタイム・ゾーンの設定
• ログ・ファイル表示許可の構成

デフォルトのログおよびトレース構成の変更

デフォルトのログおよびトレース構成は、個々のコンテナーの環境変数を設定して変更できます。

ロギングの環境変数

以下の Docker 環境変数を使用して、ログ設定を構成します。

トレースの環境変数

SIP Orchestrator 用の以下の Docker 環境変数を使用して、トレースの各種側面を制御します。

JSON ロギングが有効な場合、テナント ID とセッション ID は、名前と値のペアの形式でログ・レコードとトレース・レコードに追加されます。 SIP Orchestrator で JSON ロギングを有効にする方法については、表 4 を参照してください。 これらの名前と値のペアは、以下の場所に表示されます。

• messages.log ファイル (そのログが JSON フォーマットを使用するよう構成されている場合)
• コンソールの出力 (そのコンソールが JSON フォーマットを使用するよう構成されている場合)
• logstashCollector により Logstash に送信されたレコード

{
  "type": "liberty_message",
  "host": "e0b68506590f",
  "ibm_userDir": "/opt/ibm/wlp/usr/",
  "ibm_serverName": "defaultServer",
  "message": "CWSGW0003I: The call to the Voice Gateway disconnected for the following reason = BYE received  sessionID = EwhF6GX99x   Length of call = 4,909 ms tenantID = watson-conversation",
  "ibm_threadId": "00000083",
  "ibm_datetime": "2019-05-30T17:53:19.759+0000",
  "ibm_messageId": "CWSGW0003I",
  "module": "com.ibm.ws.cgw.session.FullDuplexSession",
  "loglevel": "INFO",
  "ibm_sequence": "1559238799759_0000000000066",
  "ext_SIPCallId": "EwhF6GX99x",
  "ext_SIPSessionId": "wlp_2_0",
  "ext_SIPASId": "wlp_2",
  "ext_thread": "Default Executor-thread-60",
  "ext_tenantID": "watson-conversation",
  "ext_sessionID": "EwhF6GX99x"
}

ログ・ファイル言語の設定

ログ・メッセージを英語以外の言語で生成する場合は、個々のコンテナーのロケールを変更して、別の言語を選択できます。 ロケールを変更するには、以下の環境変数を両方とも設定します。

ロケールおよび上記環境変数について詳しくは、Ubuntu wiki の『Locale』を参照してください。

例えば、以下の変数の場合、ログ・ファイル言語はスペイン語に設定されます。

LC_ALL=es_ES.UTF-8
LANG=es_ES.UTF-8

サポートされる以下の言語から選択できます。

ログ・ファイルのタイム・ゾーンの設定

各コンテナーのタイム・ゾーンを構成して、ログ・ファイル内のメッセージのタイム・ゾーンを変更できます。 タイム・ゾーンを構成するには、各コンテナーの TZ 環境変数を、International Assigned Numbers Authority (IANA) タイム・ゾーン・データベースの対応ゾーン名に設定します。 例えば、以下の構成はタイム・ゾーンを America/New_York に設定します。

TZ=America/New_York

IANA タイムゾーンについて詳しくは、Time Zone Database を参照してください。

ログ・ファイル表示許可の構成

Voice Gateway デプロイメント時に作成されるサーバー・ログは、other ユーザーに対し許可を与えません (-rw-r---)。 ロギングおよびトレースの構成を参照してください。

other ユーザーの読み取り権限を設定するサーバー・ログ・ファイルを作成する必要がある場合、デプロイメント構成ファイル内の WLP_SKIP_UMASK プロパティーを true に設定できます。 この構成により、更新された表示許可 -rw-r-r- を持つログ・ファイルを作成できます。