メインコンテンツまでスキップ

ロギングを設定する

ログモニタリングを使用するには、まず Setting > Monitoring > Log で収集するログを設定する必要があります。Path で収集規則を定義し、Logging で収集対象を登録します。

注記

host-agentがインストールされている必要があります。host-agentをインストールする Keyword Logging、Logging Trend、Live Tail機能は、ここで登録したログ設定を基に動作します。

1. Pathの設定​

Setting > Monitoring > Log > Path で、収集するログの規則を設定します。

clipboard

Add Path 時の設定項目は次のとおりです。

項目内容
Path NamePathの名前を設定します。
Log Typeログタイプを選択します。
Log Environmentログファイルが存在するサーバー環境を選択します。
Path Fileログファイルのパスを入力します。
Configログの出力方式を設定します。
Filter Key収集するログのキーワードを設定します。
Exclude Filter Key除外するログのキーワードを設定します。
Multi Line Typeマルチラインタイプを設定します。
Parser TypeParser Typeを選択します。
Parser Simulation実際のログとパターンを入力してパースをテストします。

2. Loggingの設定​

Setting > Monitoring > Log > Logging で、収集するログを登録します。

clipboard

Add Logging 時の設定項目は次のとおりです。

項目内容
Logging Nameログの名前を入力します。
Logging Groupログのグループを選択します。
Targetログを収集するタイプと対象を選択します。
Path Listログ収集情報(登録したPath)を選択します。

3. Logging Trendの事前設定(Elasticsearch)​

ロギングトレンドはElasticsearchに収集されたログを使用するため、以下の設定が追加で必要です。

ステップ1. exemONE Repository DB(PostgreSQL)でElasticsearchのログ設定を有効化します。

insert into xm_global_properties (props_id, name, value)
(
select uuid_generate_v4() as props_id, 'useESLog' as name, 'true' as value
where not exists (
select 1 from xm_global_properties where "name" = 'useESLog'
)
);

ステップ2. exemone-apiでElasticsearchを有効化します。({EXEM_HOME}/containers/exemone-api/configs/application.yml)

  elasticsearch:
username:
password:
hostname: <ELASTICSEARCH_HOST>
port: 9200
connection-timeout: 30000
enable: true

ステップ3. exemone-apiを再起動します。

{EXEM_HOME}/scripts/restart api

ステップ4. exemone-ingesterでElasticsearchを有効化します。({EXEM_HOME}/containers/exemone-ingester/configs/ingester.yaml)

  elasticsearch:
enabled: true
addresses:
- http://<ELASTICSEARCH_HOST>:9200
username:
password:

ステップ5. exemone-ingesterを再起動します。

{EXEM_HOME}/scripts/restart ingester

ステップ6. Setting > Log > Path で、Log Repositoryを Elasticsearch に選択してPathを追加します。

ステップ7. Setting > Log > Logging で、Elasticsearch Pathを選択してLoggingを追加します。

注記

Elasticsearchは 8バージョン以上 をサポートしています。(適用バージョン: exemone-api v3.0.506.15.50、exemone-ingester v3.0.506.15.29)