Como usar o plugin processor_appender para anexar um valor específico a um campo especificado - Simple Log Service: Central de Documentação do Alibaba Cloud

O plugin processor_appender anexa um valor específico a um campo existente ou novo e aceita variáveis de modelo no valor do campo. Esse plugin é frequentemente utilizado com plugins de monitoramento de séries temporais, como input_prometheus e input_system_v2, para enriquecer dados obtidos do Prometheus.

Importante

O Logtail 0.16.66 e versões posteriores oferecem suporte ao plugin processor_appender.

Parâmetros

Defina type como processor_appender. A tabela a seguir descreve os parâmetros do campo detail.

Tabela 1. Parâmetros do plugin

Parâmetro	Tipo	Obrigatório	Descrição
Key	string	Sim	Nome do campo.
Value	string	Sim	Valor a anexar. Aceita variáveis de modelo. Para mais informações, consulte Variáveis de modelo.
SortLabels	boolean	Não	Defina se os rótulos devem ser ordenados alfabeticamente quando Key estiver definido como __labels__. Defina este parâmetro como true para evitar erros de consulta causados por rótulos não ordenados. Valor padrão: false.

Tabela 2. Variáveis de modelo

Variável de modelo	Descrição	Exemplo de configuração	Exemplo de resultado
{{__ip__}}	Endereço IP do servidor onde o Logtail está instalado.	"Value": "{{__ip__}}"	"Value": "192.0.2.1"
{{__host__}}	Nome do host do servidor onde o Logtail está instalado.	"Value": "{{__host__}}"	"Value": "logtail-ds-xdfaf"
{{$xxxx}}	Valor da variável de ambiente especificada. O nome da variável deve começar com cifrão ($).	"Value": "{{$WORKING_GROUP}}"	"Value": "prod"

Exemplo

Considere um servidor Logtail com endereço IP 192.0.2.1, nome de host david e variável de ambiente WORKING_GROUP definida como prod. A configuração a seguir anexa esses dados ao campo __labels__:

Dados brutos
```
"__labels__":"a#$#b"
```

Configuração do plugin Logtail

{
  "processors":[
    {
      "type":"processor_appender",
      "detail": {
        "Key": "__labels__",
        "Value": "|host#$#{{__host__}}|ip#$#{{__ip__}}|group#$#{{$WORKING_GROUP}}",
        "SortLabels": true
      }
    }
  ]
}

Resultado

"__labels__":"a#$#b|group#$#prod|host#$#david|ip#$#192.0.2.1"