Simple Log Service:正規表現

次の表に、各関数のマッチングモードを示します。

マッチングモードの例：

• regex_match("abc123", r"\d+"): 一致します (デフォルトでは部分一致)。

• regex_match("abc123", r"\d+", full=True): 一致しません (完全一致が有効)。

• regex_match("abc123", r"^\d+$"): 一致しません。完全一致モードと同等です。

• e_search(r'status~="\d+"'): status フィールドの値に一致します。部分一致モードに相当します。

• e_search(r'status~="^\d+$"'): status フィールド値に一致します。完全一致モードと同等です。

正規表現には特殊文字が含まれます。これらをリテラルとして一致させるには、次のいずれかの方法でエスケープします。

• バックスラッシュ (\) でエスケープします。

  Character escaping に完全な構文が記載されています。

• str_regex_escape 関数を使用します。

  • たとえば、e_drop_fields(str_regex_escape("abc.test")) は abc.test フィールドを削除します。

  • たとえば、e_drop_fields("abc.test") は abc?test に一致するフィールドを削除します。ここで、クエスチョンマーク (?) は任意の 1 文字を表します。

丸括弧 () は、繰り返しや後方参照のために式をグループ化します。次の例にその違いを示します。

"""
処理前のログ：
SourceIP: 192.0.2.1
処理後のログ：
SourceIP: 192.0.2.1
ip: 192.0.2.1
"""
# グループなし：
e_regex("SourceIP", r"\d{1,3}\.\d{1,3}\.\d{1,3}\.\d{1,3}", "ip")
# グループあり：
e_regex("SourceIP", r"\d{1,3}(\.\d{1,3}){3}", "ip")

キャプチャグループは、開き括弧の出現順に、左から右へ1から番号が振られます。たとえば次の式には 3 つのグループがあります。

(\d{4})-(\d{2}-(\d{2}))

1     1 2      3     32

プログラムまたはプロジェクトに一致させるには、 pro(gram|ject) を使用します。一致のキャッシュが不要な場合は、非キャプチャ形式 pro(?:gram|ject) を使用します。