Pythonエージェントのログを取得する

本項の内容

Contrastを導入したことで、何らかの問題(Webサーバのプロセスのクラッシュ、特定のページにアクセスできないなど)が発生する場合があります。Contrastが原因で、クラッシュやエラーが発生した場合は弊社サポートまでご連絡頂くと同時に、次の手順に従ってPythonエージェントのログを取得してご提供ください。問題を再現したり、修正をするための重要な情報となります。

手順

Pythonエージェントのログを取得するには、下記のいずれかを設定します。

• contrast_security.ymlファイルを使用する設定：

agent:
  service:
    logger:
      path: contrast_service.log
      level: ERROR
    host: 127.0.0.1
    port: 30555
  logger:
    path: debug_contrast_agent.log
    level: DEBUG

• 環境変数を使用する設定：

CONTRAST__AGENT__LOGGER__PATH='/path/to/debug_contrast_agent.log'
CONTRAST__AGENT__LOGGER__LEVEL='DEBUG'

ログファイルに簡単にアクセスできない環境でアプリケーションを実行している場合は、下記のいずれかの方法で、標準出力にログを出力するように設定することもできます。

• contrast_security.yamlファイルを使用する設定：

agent:
 service:
   logger:
     path: contrast_service.log
     level: ERROR
   host: 127.0.0.1
   port: 30555
 logger:
   path: /dev/stdout
   level: DEBUG

• 環境変数を使用する設定：

CONTRAST__AGENT__LOGGER__LEVEL='DEBUG'
CONTRAST__AGENT__LOGGER__PATH='/dev/stdout'

ログ出力を設定したら、Pythonエージェントを組み込んだアプリケーションを起動します。Contrastがデバッグモードになり、指定したログファイルにログが記録されます。

以下のようなDEBUGメッセージがログに出力されていることを確認してください。