# Processadores de manipulação de strings
Os processadores de strings modificam valores de texto em eventos de log por meio de operações como conversão entre maiúsculas e minúsculas, corte e correspondência de padrões.
## Processador lowercase\$1string
Converte os campos especificados em minúsculas.
**Configuração**
Configure o processador lowercase\$1string com os seguintes parâmetros:
```
processor:
- lowercase_string:
with_keys: ["status", "method"]
```Parâmetros
`with_keys` (obrigatório)
Matriz de nomes de campo a serem convertidos em minúsculas. Processa apenas valores de string.
`when` (opcional)
Expressão condicional que determina se esse processador é executado. O tamanho máximo é de 256 caracteres. Consulte [Sintaxe da expressão para processamento condicional](conditional-processing.md).
## Processador uppercase\$1string
Converte campos especificados em maiúsculas.
**Configuração**
Configure o processador uppercase\$1string com os seguintes parâmetros:
```
processor:
- uppercase_string:
with_keys: ["status_code", "method"]
```Parâmetros
`with_keys` (obrigatório)
Matriz de nomes de campo a serem convertidos em maiúsculas. Processa apenas valores de string.
`when` (opcional)
Expressão condicional que determina se esse processador é executado. O tamanho máximo é de 256 caracteres. Consulte [Sintaxe da expressão para processamento condicional](conditional-processing.md).
## Processador trim\$1string
Remove todos os espaços em branco iniciais e finais de campos especificados.
**Configuração**
Configure o processador trim\$1string com os seguintes parâmetros:
```
processor:
- trim_string:
with_keys: ["message", "user_input"]
```Parâmetros
`with_keys` (obrigatório)
Matriz de nomes de campo dos quais espaços em branco serão cortados. Processa apenas valores de string.
`when` (opcional)
Expressão condicional que determina se esse processador é executado. O tamanho máximo é de 256 caracteres. Consulte [Sintaxe da expressão para processamento condicional](conditional-processing.md).
## Processador substitute\$1string
Realiza a substituição de strings usando expressões regulares.
**Configuração**
Configure o processador substitute\$1string com os seguintes parâmetros:
```
processor:
- substitute_string:
entries:
- source: "message"
from: "ERROR"
to: "WARN"
```Parâmetros
`entries` (obrigatório)
Matriz de operações de substituição a serem executadas em cada evento de log.
`entries[].source` (obrigatório)
O campo no qual realizar a substituição de string.
`entries[].from` (obrigatório)
O padrão de expressão regular a ser correspondido e substituído.
`entries[].to` (obrigatório)
A string de substituição para padrões correspondentes.
`when` (opcional)
Expressão condicional no nível de processador. Quando especificado, todo o processador será ignorado se a expressão for avaliada como false. O tamanho máximo é de 256 caracteres. Consulte [Sintaxe da expressão para processamento condicional](conditional-processing.md).
`entries[].when` (opcional)
Expressão condicional no nível de entrada. Quando especificado, somente essa entrada será ignorada se a expressão for avaliada como false. O tamanho máximo é de 256 caracteres. Consulte [Sintaxe da expressão para processamento condicional](conditional-processing.md).
`entries[].when_else` (opcional)
Entrada de fallback que é executada somente quando nenhuma das outras condições `when` no mesmo processador corresponde. O valor da expressão identifica quais condições `when` considerar. O tamanho máximo é de 256 caracteres. Consulte [Sintaxe da expressão para processamento condicional](conditional-processing.md).
## Processador truncate
Trunca valores de campo para o tamanho especificado.
**Configuração**
Configure o processador truncate com os seguintes parâmetros:
```
processor:
- truncate:
source_keys: ["message", "description"]
length: 100
start_at: 0
```Parâmetros
`source_keys` (obrigatório)
Matriz de nomes de campo a serem truncados. Cada nome de campo tem no máximo 128 caracteres.
`length` (opcional)
Comprimento máximo após o truncamento. Intervalo: 1 a 8192.
`start_at` (opcional)
Posição inicial para truncamento. Intervalo: 0 a 8192. O padrão é 0.
`when` (opcional)
Expressão condicional que determina se esse processador é executado. O tamanho máximo é de 256 caracteres. Consulte [Sintaxe da expressão para processamento condicional](conditional-processing.md).
## Processador extract\$1value
Extrai valores usando expressões regulares.
**Configuração**
Configure o processador extract\$1value com os seguintes parâmetros:
```
processor:
- extract_value:
entries:
- source: "message"
target: "extracted_data"
from: "user=(?\\w+)"
to: "${user}"
target_type: "string"
```Parâmetros
`entries` (obrigatório)
Matriz de operações de extração. Máximo de 20 entradas.
`entries[].source` (obrigatório)
Campo do qual extrair. Máximo de 128 caracteres.
`entries[].target` (obrigatório)
Campo de destino para o valor extraído. Máximo de 128 caracteres.
`entries[].from` (obrigatório)
Expressão regular pattern. Máximo de 128 caracteres.
`entries[].to` (obrigatório)
Padrão de substituição por grupos de captura. Máximo de 128 caracteres.
`entries[].target_type` (opcional)
Tipo de dados de destino (“integer”, “double”, “string”, “boolean”).
`when` (opcional)
Expressão condicional no nível de processador. Quando especificado, todo o processador será ignorado se a expressão for avaliada como false. O tamanho máximo é de 256 caracteres. Consulte [Sintaxe da expressão para processamento condicional](conditional-processing.md).
`entries[].when` (opcional)
Expressão condicional no nível de entrada. Quando especificado, somente essa entrada será ignorada se a expressão for avaliada como false. O tamanho máximo é de 256 caracteres. Consulte [Sintaxe da expressão para processamento condicional](conditional-processing.md).
`entries[].when_else` (opcional)
Entrada de fallback que é executada somente quando nenhuma das outras condições `when` no mesmo processador corresponde. O valor da expressão identifica quais condições `when` considerar. O tamanho máximo é de 256 caracteres. Consulte [Sintaxe da expressão para processamento condicional](conditional-processing.md).
## Processador convert\$1entry\$1type
Converte valores de campo entre tipos de dados diferentes.
**Configuração**
Configure o processador convert\$1entry\$1type com os seguintes parâmetros:
```
processor:
- convert_entry_type:
key: "count"
type: "integer"
```Parâmetros
`key` (obrigatório)
Nome de campo único a ser convertido.
`type` (obrigatório)
Tipo de dados de destino. Opções: “integer”, “double”, “string”, “boolean”.
`when` (opcional)
Expressão condicional que determina se esse processador é executado. O tamanho máximo é de 256 caracteres. Consulte [Sintaxe da expressão para processamento condicional](conditional-processing.md).
## Processador date
Converte e formata campos de data/hora.
**Configuração**
Configure o processador date com os seguintes parâmetros:
```
processor:
- date:
match:
- key: "timestamp"
patterns: ["yyyy-MM-dd'T'HH:mm:ss.SSSSSS'Z'"]
destination: "@timestamp"
source_timezone: "UTC"
destination_timezone: "America/New_York"
```Parâmetros
`match` (obrigatório)
Matriz de configurações de correspondência de datas. Máximo de 10 entradas.
`match[].key` (obrigatório)
Campo contendo a string de data. Máximo de 128 caracteres.
`match[].patterns` (obrigatório)
Matriz de padrões de formato de data a serem experimentados. Máximo de 5 padrões, cada um com até 256 caracteres.
`destination` (opcional)
Campo de destino único para todas as datas analisadas. Máximo de 128 caracteres.
`source_timezone` (opcional)
Fuso horário da origem para análise.
`destination_timezone` (opcional)
Fuso horário do destino para saída.
`output_format` (opcional)
Formato de data da saída. Máximo de 64 caracteres.
`destination_type` (opcional)
Tipo de saída: “timestampz”, “long” ou “string”.
`when` (opcional)
Expressão condicional que determina se esse processador é executado. O tamanho máximo é de 256 caracteres. Consulte [Sintaxe da expressão para processamento condicional](conditional-processing.md).
## Processador dissect
Extrai dados estruturados usando correspondência de padrões.
**Configuração**
Configure o processador dissect com os seguintes parâmetros:
```
processor:
- dissect:
map:
message: "%{timestamp} %{level}"
```Parâmetros
`map` (obrigatório)
Mapeamento de campos com padrões de dissecação.
`when` (opcional)
Expressão condicional que determina se esse processador é executado. O tamanho máximo é de 256 caracteres. Consulte [Sintaxe da expressão para processamento condicional](conditional-processing.md).
## Processador list\$1to\$1map
Converte campos de matriz em estruturas de mapa.
**Configuração**
Configure o processador list-to-map com os seguintes parâmetros:
```
processor:
- list_to_map:
source: "tags"
key: "name"
value_key: "value"
target: "tag_map"
```Parâmetros
`source` (obrigatório)
Campo contendo dados de matriz. Máximo de 128 caracteres.
`key` (obrigatório)
Nome do campo a ser usado como chave do mapa. Máximo de 128 caracteres.
`value_key` (opcional)
Nome do campo a ser usado como valor do mapa. Máximo de 128 caracteres.
`target` (opcional)
Campo de destino para a estrutura do mapa. Máximo de 128 caracteres.
`flatten` (opcional)
Se o mapa resultante deve ou não ser nivelado.
`flattened_element` (opcional)
Qual elemento usar ao nivelar (“first” ou “last”).
`when` (opcional)
Expressão condicional que determina se esse processador é executado. O tamanho máximo é de 256 caracteres. Consulte [Sintaxe da expressão para processamento condicional](conditional-processing.md).
## Processador rename\$1keys
Renomeia campos em eventos de log.
**Configuração**
Configure o processador rename\$1keys com os seguintes parâmetros:
```
processor:
- rename_keys:
entries:
- from_key: "old_name"
to_key: "new_name"
overwrite_if_to_key_exists: true
```Parâmetros
`entries` (obrigatório)
Matriz de operações de renomeação. Máximo de 5 entradas.
`entries[].from_key` (obrigatório)
Nome de campo atual. Máximo de 128 caracteres.
`entries[].to_key` (obrigatório)
Nome do novo campo. Máximo de 128 caracteres.
`entries[].overwrite_if_to_key_exists` (opcional)
Se o campo de destino existente deve ou não ser substituído.
`when` (opcional)
Expressão condicional no nível de processador. Quando especificado, todo o processador será ignorado se a expressão for avaliada como false. O tamanho máximo é de 256 caracteres. Consulte [Sintaxe da expressão para processamento condicional](conditional-processing.md).
`entries[].when` (opcional)
Expressão condicional no nível de entrada. Quando especificado, somente essa entrada será ignorada se a expressão for avaliada como false. O tamanho máximo é de 256 caracteres. Consulte [Sintaxe da expressão para processamento condicional](conditional-processing.md).
`entries[].when_else` (opcional)
Entrada de fallback que é executada somente quando nenhuma das outras condições `when` no mesmo processador corresponde. O valor da expressão identifica quais condições `when` considerar. O tamanho máximo é de 256 caracteres. Consulte [Sintaxe da expressão para processamento condicional](conditional-processing.md).
## Processador select\$1entries
Seleciona apenas campos especificados dos eventos.
**Configuração**
Configure o processador select\$1entries com os seguintes parâmetros:
```
processor:
- select_entries:
include_keys: ["timestamp", "level", "message"]
```Parâmetros
`include_keys` (obrigatório)
Matriz de nomes de campo a serem mantidos. Máximo de 50 chaves, cada uma com até 128 caracteres.
`when` (opcional)
Expressão condicional que determina se esse processador é executado. O tamanho máximo é de 256 caracteres. Consulte [Sintaxe da expressão para processamento condicional](conditional-processing.md).
## Processador translate
Traduz valores de campo usando tabelas de pesquisa.
**Configuração**
Configure o processador translate com os seguintes parâmetros:
```
processor:
- translate:
mappings:
- source: "status_code"
targets:
- target: "status_text"
map:
"200": "OK"
"404": "Not Found"
```Parâmetros
`mappings` (obrigatório)
Conjunto de configurações de tradução. Máximo de 10 mapeamentos.
`mappings[].source` (obrigatório)
Campo a traduzir. Máximo de 128 caracteres.
`mappings[].targets` (obrigatório)
Conjunto de configurações de destino. Máximo de 10 alvos.
`mappings[].targets[].target` (obrigatório)
Nome de campo de destino. Máximo de 128 caracteres.
`mappings[].targets[].map` (obrigatório)
Mapeamento de tradução. Máximo de 100 entradas, cada valor com até 512 caracteres.
`when` (opcional)
Expressão condicional que determina se esse processador é executado. O tamanho máximo é de 256 caracteres. Consulte [Sintaxe da expressão para processamento condicional](conditional-processing.md).