Configuración de la inclusión o exclusión de registros

Puede especificar si los registros se incluyen o excluyen de la recopilación en función de una ruta o un nombre de archivo configurados.

Incluidos los caminos

Para especificar las rutas incluidas, siga estos pasos:

Inicie una sesión en el clúster. Para más información, consulte Acceda a su clúster.
En el mapa de configuración Agente de registro, localice la sección input-kubernetes.conf. A continuación, actualice el parámetro Path para especificar las fuentes de registro que desea recopilar.

Por defecto, el Agente de registro recopila registros de una única fuente ubicada en /var/log/containers/. Asegúrese de añadir las rutas de origen de registro deseadas al parámetro Path para sus requisitos específicos. Separe cada vía de acceso con una coma.
```
input-kubernetes.conf: |
[INPUT]
    Name              tail
    Tag               kube.*
    Path              /var/log/containers/*.log,/path/to/your/logs/*.log
    Path_Key          file
```
Se pueden especificar fuentes de registro adicionales separadas por comas en el parámetro Path.

De forma predeterminada, el Agente de registro IBM Cloud Logs recopila registros solo del directorio /var/log/containers/*.log. Si desea recopilar registros de todos los subdirectorios de /var/log, debe añadir /var/log/**/*.log al parámetro Path.

Reinicie los pods de agentes.

Para clústeres Kubernetes, ejecute:

kubectl -n ibm-observe rollout restart ds/logs-agent

Para clústeres OpenShift, ejecute:

oc -n ibm-observe rollout restart ds/logs-agent

Excluir rutas

Para especificar las rutas que deben excluirse, siga estos pasos:

Inicie una sesión en el clúster. Para más información, consulte Acceda a su clúster.
En el mapa de configuración Agente de registro, localice la sección input-kubernetes.conf. A continuación, actualice el parámetro Exclude_Path para especificar las fuentes de registro que desea excluir de la recopilación. Este parámetro permite especificar rutas que deben ser ignoradas por el Agente de registro.

Es posible que el parámetro Exclude_Path no esté presente por defecto, por lo que puede que tengas que añadirlo si no existe. Este parámetro permite especificar las rutas que deben ser ignoradas por el Agente de registro.
```
input-kubernetes.conf: |
[INPUT]
    Name              tail
    Tag               kube.*
    Path              /var/log/containers/logger-agent-ds-*.log,/path/to/your/logs/*.log
    Path_Key          file
    Exclude_Path      /path/to/your/logs/exclude-1.log,/path/to/your/logs/exclude-2.log
```
Se pueden especificar fuentes de registro adicionales separadas por comas en el parámetro Exclude_Path.

Reinicie los pods de agentes.

Para clústeres Kubernetes, ejecute:

kubectl -n ibm-observe rollout restart ds/logs-agent

Para clústeres OpenShift, ejecute:

oc -n ibm-observe rollout restart ds/logs-agent

Ejemplo

Considere el siguiente ejemplo con Exclude_Path especificado:

Por ejemplo, si su estructura de directorios es

/path/to/your/logs
                ├── app1.log
                ├── app2.log
                ├── exclude-1.log
                └── exclude-2.log

Puede modificar la sección input-kubernetes.conf de la siguiente manera:

input-kubernetes.conf: |
    [INPUT]
        Name              tail
        Tag               kube.*
        Path              /var/log/containers/logger-agent-ds-*.log,/path/to/your/logs/*.log
        Path_Key          file
        Exclude_Path      /path/to/your/logs/exclude-1.log,/path/to/your/logs/exclude-2.log

En este ejemplo:

El parámetro Path especifica dos rutas a incluir:
- /var/log/containers/logger-agent-ds-*.log
- /path/to/your/logs/*.log
El parámetro Exclude_Path se utiliza para especificar dos rutas adicionales que deben excluirse:
- /path/to/your/logs/exclude-1.log
- /path/to/your/logs/exclude-2.log

Todos los archivos del directorio que coincidan con el patrón especificado en el parámetro Path serán recopilados por el Agente de registro, excepto aquellos que coincidan con los patrones especificados en Exclude_Path.