one.newrelic.comのログUIを使用して、ログデータを数秒ですばやく検索できます。各ログには、利用可能な属性がlog_summary
列に一覧表示されます。追加の詳細にドリルダウンするには、強調表示された属性をクリックします。
始める準備はできていますか?まだお持ちでない場合は、New Relicアカウントにサインアップしてください。永久無料です。
クエリの構造
ログUIを使用すると、 new
やrelic
などの単純なキーワード、または"new relic agent"
などのフレーズを検索フィールドに直接入力して、ログデータを検索できます。
単純な用語は、ログのmessage
属性の「含む」検索です。たとえば、 "New Relic Agent"
はより詳細なmessage: "*New Relic Agent*"
と同等です。
他の属性を検索するには、 source: "*New Relic agent*"
などの用語の前に属性を付けます。詳細については、以下の「一般的な演算子」を参照してください。
キーワードやフレーズを演算子と組み合わせて、より複雑なクエリを作成することもできます。
ヒント
New Relic のログクエリは Lucene クエリ言語に基づいており、この文書に記載されているすべての Lucene 関数がサポートされています。(Lucene の機能が記載されていない場合は、サポートしていません。) 参考となる例は、 Lucene tutorial をご覧ください。
一般的なクエリのルール
ログクエリのルール | コメント |
---|---|
大文字小文字の区別 | クエリの構文は、属性値の大文字と小文字を区別します。属性名は常に大文字と小文字を区別します。 例外: ワイルドカード検索は、属性値の大文字・小文字を区別しません。 |
空白文字 | 用語にスペースやタブ文字などの空白文字が含まれている場合、その用語は二重引用符で囲む必要があります。 例:正確に
注:属性のどこかに |
特殊文字 | 用語に特殊文字が含まれている場合は、用語を二重引用符で囲み、円記号( 例:正確に
|
ワイルドカード検索 | アスタリスク( 例:どこかに
用語にスペースまたはその他のメタ文字が含まれている場合(上記を参照)、ワイルドカード用語を引用符で囲む必要があります。 たとえば、どこかに
|
テキストで検索
より具体的な検索結果を得るためには、キーワードやフレーズを組み合わせたテキスト検索が有効です。
テキスト演算子
Logsのクエリ構文では、以下のテキスト演算子を使用できます。
条件 | テキスト演算子の例 |
---|---|
マッチング(キーワード) | 別々に入力したキーワードを含むログ結果を検索します。
|
完全一致(フレーズ) | 入力された特定のフレーズを含むログ結果を検索します。
|
Either / Or | 入力されたキーワードのいずれか、または両方を含むログ結果を検索します。
|
そして | 入力されたキーワードの両方を含むログ結果を検索します。
|
* ワイルドカード(0個以上) | 入力されたキーワードの両方を含み、その間に0文字以上の文字があるログ結果を検索します。
|
否定(キーワード) | 入力された特定のキーワードを含まないログ結果を検索します。
|
否定(フレーズ) | 入力された特定の語句を含まないログ結果を検索します。
|
属性で探す
特定の属性やフィールドにクエリ結果を絞り込むには、属性検索を使用します。
一般的なオペレーター
以下の演算子は、すべてのタイプの属性で使用できます。
条件 | 一般的なオペレーターの例 |
---|---|
同等 | 属性が指定されたキーワードと等しいログ結果を検索します。例:フィールド
|
等しくない | 属性が指定されたキーワードと等しくないログ結果を検索します。例:フィールド
|
収録内容 | 属性に指定されたキーワードが含まれているログ結果を検索します。例:フィールド
|
含まれていません | 属性に指定されたキーワードが含まれていないログ結果を検索します。例:フィールド
|
で始まる | 指定されたキーワードで属性が始まるログ結果を検索します。例:フィールド
|
で終わる | 指定されたキーワードで属性が終了するログ結果を検索します。例:フィールド
|
持っています。 | 指定されたフィールドを持つログ結果を検索します。例:フィールド
|
ミッシング | 指定されたフィールドが欠落しているログ結果を検索します。例:フィールド
|
数値演算子
以下の演算子は、数値属性でのみ使用できます。
条件 | 数値演算子の例 |
---|---|
より大きい | 指定されたパラメーターよりも大きいログ結果属性の一致を検索します。例:フィールド
|
より大きいか等しい | 指定されたパラメーター以上の属性一致を持つログ結果を検索します。例:フィールド
|
未満 | 指定されたパラメーターよりも少ない属性一致を持つログ結果を検索します。例:フィールド
|
以下の場合 | 指定されたパラメーター以下の属性一致を持つログ結果を検索します。例:フィールド
|
例:デプロイメントのURIで文字列を検索する
URIにログ検索文字列を含むNewRelicURLを作成できます。これは、たとえば、KubernetesデプロイメントにNew RelicLogsUIへの直接リンクを含める場合に役立ちます。リンクに、特定のコンテナ名の検索で入力されたカスタムURLを渡す必要があります。
URLの例を次に示します。
https://one.newrelic.com/launcher/logger.log-launcher?platform[accountId]=1234567&launcher=jyJpc0VudGl0&pane=zyJuZXJkbGV0SWQiO=
この検索では、クエリはLuceneクエリです。必要に応じて、次の値を編集します。
accountId
あなたのアカウントです。eventTypes
ログパーティションです(通常はLog
)。
他の値を編集する必要はありません。
launcher
は、次のBase64エンコーディングです。
'{"isEntitled":true,"query":"foo:\\"bar\\" environment:\\"production\\"","eventTypes":["Log"]}'
pane
は、次のBase64エンコーディングです。
'{"nerdletId":"logger.log-tailer","accountId":1234567}'