---
title: カスタムログ
category: オペレーション
weight: 75
---

カスタムログではオリジナル処理から出力したログの内容を確認できます。  
ログはオリジナル処理で`{logger msg1=$json msg2=$output msg3=$smarty.request msg4='test4'}`のように仕込んでください。  

## カスタムログの確認方法

[オペレーション] -> [ログ管理]をクリックします。

![Image from Gyazo](https://t.gyazo.com/teams/diverta/bec37ecc842bbf4422d0bb77e4f6b3d2.png)

ページタイトルの上の[ログ管理]をクリックし、表示されたプルダウンの中にある[カスタムログ]をクリックします。

![Image from Gyazo](https://t.gyazo.com/teams/diverta/eaa0f49514839d569bd575937e7f1c25.png)

## カスタムログの項目説明

![Image from Gyazo](https://t.gyazo.com/teams/diverta/e4606a058981caae774307ce5da67dc5.png)

### 絞り込み条件

カスタムログではキーワードやログ日時による絞り込みと、詳細検索を用意しています。

#### キーワードによる絞り込み

![Image from Gyazo](https://t.gyazo.com/teams/diverta/0698d62ead29b80f7ae4d3bd9b87a61c.png)

[キーワード] テキストボックスに検索するキーワードを入力します。キーワードを含むログを絞り込みます。

#### ログ日時による絞り込み

![Image from Gyazo](https://t.gyazo.com/teams/diverta/a8a987664cbb71c2f5151ce20789c651.png)

ログ日時の開始と終了で期間選択します。選択した期間のログを絞り込みます。  
指定できるログの期間は35日間となります。過去のログ日時を指定する場合も35日間の範囲となるように指定してください。

#### 詳細検索

[詳細検索] ボタンをクリックすると、絞り込み条件を作成できます。

![Image from Gyazo](https://t.gyazo.com/teams/diverta/b3040e7d790797adf428eaa344c059b9.png)

絞り込み対象として指定できる項目は次の通りです。

|項目 | 説明 | 指定できる条件 |
| :--- | :--- | :--- |
|ホスト|リクエストの送信されたAPI domain|[検索条件](#検索に利用できるオペレーションについて)|
|ログレベル|メッセージの重要度を示すログレベル|[検索条件](#検索に利用できるオペレーションについて)|
|メッセージ[1]|オリジナル処理で設定した`msg1`の内容|[検索条件](#検索に利用できるオペレーションについて)|
|メッセージ[2]|オリジナル処理で設定した`msg2`の内容|[検索条件](#検索に利用できるオペレーションについて)|
|メッセージ[3]|オリジナル処理で設定した`msg3`の内容|[検索条件](#検索に利用できるオペレーションについて)|
|メッセージ[4]|オリジナル処理で設定した`msg4`の内容|[検索条件](#検索に利用できるオペレーションについて)|
|URI|リクエストが行われたエンドポイントのURI|[検索条件](#検索に利用できるオペレーションについて)|
|送信元IPアドレス|リクエストを行ったユーザーのIPアドレス|[検索条件](#検索に利用できるオペレーションについて)|
|メンバーID|リクエストを送ったメンバーのID|[検索条件](#検索に利用できるオペレーションについて)|
|アプリケーション・リクエストID| Kurocoのリクエスト識別子|[検索条件](#検索に利用できるオペレーションについて)|
|ユーザーエージェント|APIを要求したユーザーエージェント|[検索条件](#検索に利用できるオペレーションについて)|

詳細検索は複数の条件をAND、またはORで連結できます。ANDの場合は指定した条件すべてにマッチするデータのみを対象とします。OR条件は指定した条件のいずれかにマッチするデータを対象とします。

#### 検索に利用できるオペレーションについて

検索では次のオペレーションが指定できます。

| オペレーション   | 型 | 対象となるデータ |
| :---               | :--- | :--- |
| 含む            |  文字列 | 条件が一部に一致するデータ |
| 含まない        | 文字列 | 条件がいずれにも一致しないデータ |
| =               | 文字列・数値 | 条件に一致するデータ |
| !=              | 文字列・数値 | 条件に一致しないデータ |
| <               | 文字列・数値 | 条件未満のデータ |
| >               | 文字列・数値 | 条件より大きいデータ |
| <=              | 文字列・数値 | 条件以下のデータ |
| >=              | 文字列・数値 | 条件以上のデータ |
| で始まる         | 文字列 | 条件ではじまるデータ |
| で始まらない     | 文字列 | 条件ではじまらないデータ |
| で終わる         | 文字列 | 条件で終わるデータ |
| で終わらない     | 文字列 | 条件で終わらないデータ |
| どれかを含む     | 文字列・数値 | 条件を複数指定し、いずれかの条件に一致するデータ |
| どれも含まない   | 文字列・数値 | 条件を複数指定し、いずれの条件にも一致しないデータ |

##### 並び順について

ソートキーと表示順を選択することで検索結果の並び順を指定できます。並び順はASC（昇順。小さい方から大きくなっていく）またはDESC（降順。大きい方から小さくなっていく）を指定できます。

### ログ一覧項目

ログとして一覧されるデータの項目は次の通りです。

|項目 | 説明 |
| :--- | :--- |
|ログ日時|ログの記録された日時を表示します。|
|ホスト|リクエストの送信されたAPI domainを表示します。|
|ログレベル|メッセージの重要度を示すログレベルを表示します。詳細は[レベルについて](#レベルについて) を参照してください。|
|メッセージ[1]|オリジナル処理で設定した`msg1`の内容を表示します。|
|メッセージ[2]|オリジナル処理で設定した`msg2`の内容を表示します。|
|メッセージ[3]|オリジナル処理で設定した`msg3`の内容を表示します。|
|メッセージ[4]|オリジナル処理で設定した`msg4`の内容を表示します。|
|URI|リクエストが行われたエンドポイントのURIを表示します。|
|送信元IPアドレス|リクエストを行ったユーザーのIPアドレスを表示します。|
|メンバーID|リクエストを送ったメンバーのIDを表示します。|
|アプリケーション・リクエストID| Kurocoのリクエスト識別子を表示します。|
|ユーザーエージェント|APIを要求したユーザーエージェントを表示します。|

#### レベルについて

メッセージの重要度を示すレベルは以下の3段階があります

- warn
- notice
- info

### ボタンの説明
![Image from Gyazo](https://t.gyazo.com/teams/diverta/03b13c4e8888d6c1169daa4a0be749d3.png)

| ボタン  | 説明 |
| :--- | :--- |
| 検索する | 指定した絞り込み条件で検索します。 |
| ダウンロードする | ログ一覧で表示しているログ情報をダウンロードします。 |
| 削除する | ログ一覧で表示しているログ情報を削除します。 |

### ログ一覧のダウンロード
[ダウンロードする]ボタンをクリックするとダウンロード設定が開きます。
![Image from Gyazo](https://t.gyazo.com/teams/diverta/c9f1d8298cde8e94237984452ab63537.png)

![Image from Gyazo](https://t.gyazo.com/teams/diverta/9c0de24b0571392b4b347c49feaf6cd8.png)

| 項目 | 説明 |
| :--- | :--- |
| 文字コード | CSVファイルの文字コードを設定します。 |
| キャンセル | ダウンロードをキャンセルします。 |
| ダウンロードする | ダウンロードします。 |