Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Prozessoren, die Zeichenketten mutieren

Dieser Abschnitt enthält Informationen zu den Prozessoren für Zeichenkettenmutationen, die Sie mit einem Log-Event-Transformator verwenden können.

lowerCaseString

Der lowerCaseString Prozessor konvertiert eine Zeichenfolge in ihre kleingeschriebene Version.

Beispiel

Nehmen wir das folgende Beispiel für ein Protokollereignis:

{
    "outer_key": {
        "inner_key": "INNER_VALUE"
    }
}

Die Transformer-Konfiguration sieht wie folgt lowerCaseString ausparseJSON:

[
    {
        "parseJSON": {}
    },
    {
        "lowerCaseString": {
            "withKeys":["outer_key.inner_key"]
        }
    }
]

Das transformierte Protokollereignis wäre das Folgende.

{
  "outer_key": {
    "inner_key": "inner_value"
  }
}

upperCaseString

Der upperCaseString Prozessor konvertiert eine Zeichenfolge in ihre Großbuchstabenversion.

Beispiel

Nehmen wir das folgende Beispiel für ein Protokollereignis:

{
    "outer_key": {
        "inner_key": "inner_value"
    }
}

Die Transformer-Konfiguration sieht wie folgt upperCaseString ausparseJSON:

[
    {
        "parseJSON": {}
    },
    {
        "upperCaseString": {
            "withKeys":["outer_key.inner_key"]
        }
    }
]

Das transformierte Protokollereignis wäre das Folgende.

{
  "outer_key": {
    "inner_key": "INNER_VALUE"
  }
}

SplitString

Der splitString Prozessor ist eine Art von String-Mutate-Prozessor, der ein Feld mithilfe eines Trennzeichens in ein Array aufteilt.

Beispiel 1

Nehmen wir das folgende Beispiel für ein Protokollereignis:

[
    {
        "parseJSON": {}
    },
    {
        "splitString": {
            "entries": [
                {
                    "source": "outer_key.inner_key",
                    "delimiter": "_"
                }
            ]
        }
    }
]

Die Transformer-Konfiguration sieht wie folgt splitString ausparseJSON:

[
     {
        "parseJSON": {}
    },
    {
         "splitString": {
            "entries": [
                {
                    "source": "outer_key.inner_key",
                    "delimiter": "_"
                }
            ]
        }
    }
]

Das transformierte Protokollereignis wäre das Folgende.

{
  "outer_key": {
    "inner_key": [
      "inner",
      "value"
    ]
  }
}

Beispiel 2

Das Trennzeichen, anhand dessen die Zeichenfolge aufgeteilt werden soll, kann mehrere Zeichen lang sein.

Nehmen wir das folgende Beispiel für ein Protokollereignis:

{
    "outer_key": {
        "inner_key": "item1, item2, item3"
    }
}

Die Konfiguration des Transformators sieht wie folgt aus:

[
     {
        "parseJSON": {}
    },
    {
         "splitString": {
            "entries": [
                {
                    "source": "outer_key.inner_key",
                    "delimiter": ", "
                }
            ]
        }
    }
]

Das transformierte Protokollereignis wäre das Folgende.

{
  "outer_key": {
    "inner_key": [
      "item1",
      "item2",
      "item3"
    ]
  }
}

SubstituteString

Der substituteString Prozessor ist ein Typ eines String-Mutationsprozessors, der den Wert eines Schlüssels mit einem regulären Ausdruck vergleicht und alle Treffer durch eine Ersatzzeichenfolge ersetzt.

Beispiel 1

Nehmen wir das folgende Beispiel für ein Protokollereignis:

{
    "outer_key": {
        "inner_key1": "[]",
        "inner_key2": "123-345-567",
        "inner_key3": "A cat takes a catnap."
    }
}

Die Transformer-Konfiguration sieht wie folgt substituteString ausparseJSON:

[
    {
        "parseJSON": {}
    },
    {
        "substituteString": {
            "entries": [
                {
                    "source": "outer_key.inner_key1",
                    "from": "\\[\\]",
                    "to": "value1"
                },
                {
                    "source": "outer_key.inner_key2",
                    "from": "[0-9]{3}-[0-9]{3}-[0-9]{3}",
                    "to": "xxx-xxx-xxx"            
                },
                {
                    "source": "outer_key.inner_key3",
                    "from": "cat",
                    "to": "dog"            
                }
            ]
        }
    }
]

Das transformierte Protokollereignis wäre das Folgende.

{
  "outer_key": {
    "inner_key1": "value1",
    "inner_key2": "xxx-xxx-xxx",
    "inner_key3": "A dog takes a dognap."
  }
}

Beispiel 2

Nehmen wir das folgende Beispiel für ein Protokollereignis:

{
    "outer_key": {
        "inner_key1": "Tom, Dick, and Harry",
        "inner_key2": "arn:aws:sts::123456789012:assumed-role/MyImportantRole/MySession"
    }
}

Die Transformer-Konfiguration sieht wie folgt substituteString ausparseJSON:

[
    {
        "parseJSON": {}
    },
    {
        "substituteString": {
            "entries": [
                {
                    "source": "outer_key.inner_key1",
                    "from": "(\w+), (\w+), and (\w+)",
                    "to": "$1 and $3"            
                },
                {
                    "source": "outer_key.inner_key2",
                    "from": "^arn:aws:sts::(?P<account_id>\\d{12}):assumed-role/(?P<role_name>[\\w+=,.@-]+)/(?P<role_session_name>[\\w+=,.@-]+)$",
                    "to": "${account_id}:${role_name}:${role_session_name}"
                }
            ]
        }
    }
]

Das transformierte Protokollereignis wäre das Folgende.

{
  "outer_key": {
    "inner_key1": "Tom and Harry",
    "inner_key2": "123456789012:MyImportantRole:MySession"
  }
}

TrimString

Der trimString Prozessor entfernt Leerzeichen am Anfang und Ende eines Schlüssels.

Beispiel

Nehmen wir das folgende Beispiel für ein Protokollereignis:

{
    "outer_key": {
        "inner_key": "   inner_value  "
    }
}

Die Transformer-Konfiguration sieht wie folgt trimString ausparseJSON:

[
    {
        "parseJSON": {}
    },
    {
        "trimString": {
            "withKeys":["outer_key.inner_key"]
        }
    }
]

Das transformierte Protokollereignis wäre das Folgende.

{
  "outer_key": {
    "inner_key": "inner_value"
  }
}