Lucene を使用したデータの照会

IBM Cloud Logs ログデータは、Luceneまたは DataPrime を使用して検索できます。 DataPrime, を使用したクエリに関する詳細については、「 DataPrime を使用したデータのクエリ」を参照してください。

検索は、フィルター操作および時間による制限と組み合わせて使用できます。

Explore へのアクセス

「探索」画面からログを照会できます。

IBM Cloud Logs UI を起動します。
「ログの探索」 アイコン > 「ログ」 をクリックします。
(オプション) 分析とアラートまたは保管および検索パイプラインからアーカイブ・データを探索する場合は、 「アーカイブ」 をクリックします。優先順位の洞察パイプラインで現在保守されているデータに戻すには、 「優先順位ログ」 をクリックします。

優先順位の洞察で検索しても、期待したデータが表示されない場合は、「Priority Insights の検索結果が表示されないのはなぜですか？」をご覧ください。

Lucene 照会は、 Terms と Operatorsで構成されています。用語は、アナライザーによってログ・データから抽出されます。用語には2つの種類があります：

IBM Cloud Logs は、以下の検索タイプを提供します。

フリー・テキスト検索

フリー・テキスト検索は、ログ・データ内の任意のフィールドの用語を突き合わせるために使用されます。テキストを二重引用符（"）で囲んでください。

フィールド検索

フィールド検索では、検索語に一致する必要がある特定のフィールドに検索が制限されます。テキストを二重引用符（"）で囲んでください。

範囲検索

範囲検索では、一致する数値の範囲を照会できます。

正規表現検索

正規表現検索では、正規表現を使用してログ・データ内のパターンを突き合わせることができます。 Lucene 標準演算子がサポートされています。

突き合わせる正規表現パターンは、スラッシュ (/) で囲む必要があります。

キーワードはアナライザーを介して渡されないため、可能な限り、キーワードに対して正規表現検索を使用してください。

以下に、さまざまなタイプの検索とその結果の例を示します。

フリー・テキスト検索の例
照会	結果
`a very interesting log message`	これらの用語を含むログに一致します。これらは、任意のフィールドに任意の順序で表示できます。
`“a very interesting log message”`	任意のフィールド内のこの句と完全に一致します。

フィールド検索の例
照会	結果
`msg:interesting`	msg フィールドにこの用語が含まれているログに一致します。
`msg:“a very interesting log message!”`	msg フィールドの句と完全に一致します。
`msg.keyword:”a very interesting message!”`	句 (! を含む) を含むログに一致します。
`msg.keyword:/.*/ AND NOT msg.keyword:/^$/`	フィールドに値があり、空文字列("")でないログにマッチします

範囲検索の例
照会	結果
`status_code.numeric:[200 TO 299]`	200 から 299 (200 と 299 を含む) の間の状況コードに一致します。
`status_code.numeric:{199 TO 300}`	200 から 299 (199 と 300 を除く) の間の状況コードに一致します。
`status_code.numeric:[200 TO 300}`	200 から 299 までの状況コードに一致します (200 を含みますが、300 は除きます)。
`status_code.numeric:{199 TO 299]`	200 から 299 までの状況コードに一致します (199 を除くが 299 を含む)。
`status_code.numeric:<300`	ステータスコード300未満（300は含まない）に一致します。
`status_code.numeric:>0.003`	0.003 より大きいステータスコードに一致します（ 0.003 は含みません）。

正規表現検索の例
照会	結果
`msg.keyword:/.what an interesting message!./`	「what an たいメッセージ!」(! を含む) というパターンを含むログに一致します。
`version.keyword:/.v.[1-5].[0-9]{2}./`	バージョン・フィールドに “v.1.24” または “v.5.69” などのパターンが含まれているログに一致します。

配列の検索例
照会	結果
`FirewallMatchesActions:"abc" OR FirewallMatchesActions:"123"`	`abc` または `123` という文字列を含むログに一致します。
`FirewallMatchesActions.keyword:/(abc\|123)/`	正規表現を使用して、 `abc` または `123` という文字列を正確に含むログに一致します。
`FirewallMatchesActions.keyword:/.(abc\|123)./`	正規表現を使用して、 `abc` または `123` の部分文字列を含む文字列とログを照合します。

演算子 AND、 OR、および NOT を使用して、複数のフィルターを組み合わせることができます。また、1 つの照会に複数の演算子がある場合は、括弧を使用して演算子の優先順位を指定することもできます。

演算子を使用した照会の例
照会	結果
`msg:”failed transaction” AND level: “ERROR” NOT env:”staging”`	「failed transaction」という句を含むが「staging environment」からではない ERROR レベルのログに一致します。
`(msg:”failed transaction” AND (cluster:”eu” OR cluster:”us”)) NOT env:”staging”`	「failed transaction」という句を含む「eu」または「us」クラスターからのログに一致しますが、「staging environment」からのログには一致しません。

すべてのフィルターおよび照会をクリアするには、 「リセット」 をクリックします。

フィルターまたは検索を使用して表示したいログ・レコードがビューに表示されたら、将来の使用のためにそのビューを保存することができます。

ビューを保存するには