En el presente documento se describe la configuracion de Humio en los clusters de AKS de Produccion ( prod) para que envien su log a dicha plataforma.

1. CONTROL DE VERSIONES DEL DOCUMENTO
Autor Javier Caparo
Version 1.0
Fecha 15/09/2021

2. Humio-Logging

Introduccion

  • Humio es un aplataforma de logging y asi sera usada en TdP AD.

  • Cuando se trata de administrar microservicios en un clúster de Kubernetes, Humio es una excelente manera de obtener información sobre sus aplicaciones. Si bien se admiten otros remitentes de registros, seenfocamos en usar Fluent Bit para reenviar mensajes de registro a Humio.

Como se envian los logs de los AKS cluster a Humio cuando no exister el clsuter aun?

  • Cada mesa de TdP que necesite enviar logs de sus clusters AKS a Humio , recibira un token por parte de lso equipos de Operaciones de TdP ( se evlauara si se necesita enviar los logs de ese cluster en 1er termino).

  • Si se crea el Cluster de AKS de Produccion de la mesa y se necesita enviar los logs a Humio , el pipeline de Jenkins "deploy-cloud-platform" tiene el parametro para haboilitar esta opcion y si se escoge "ENABLED" entocnes el otro dato obligatporio sera el # de token de Humio que se le ha proporcionado a esa mesa.

  • de esa manera el cluster de AKS Prod en su etapa de creacion ya se configurara automaticamnete para enviar sus logs a Humio.

Que pasa si ya existe el cluster pero se quiere enviar sus logs a Humio?

  • Prerequisitos:

  1. tener instalado az cli, kubectl y helm en una shell para ejecutar los pasos que se indican lineas abajo.

  2. Tener acceso al cluster con :

    az aks get-credentials –n <nombre del cluster> -g <resource group de cluster>

  3. Tener el token enviado por Operaciones/Ingenieria.

  • Y los pasos a seguir son:

  • Crear el archivo: humio-agent.yaml con esta lineas:

humio-fluentbit:
  enabled: true
  humioHostname: ingesthumio.movistar.com.pe 
  es:
    port: 443
    tls: true
    tls_verify: false
  customFluentBitConfig:
    custom-filter-kubernetes.conf: |-
      [FILTER]
       Name     modify
       Match    *
       Rename   log rawstring
  • Ejecutar este commando de helm ( se debe tener el dato del token asignado) y reemplzar el token dado donde dice "xxxx-xxxx-xxxx-xxxx":
humio_token=xxxx-xxxx-xxxx-xxxx
kubectl create ns humio
helm repo add humio https://humio.github.io/humio-helm-charts
helm repo update
helm install humio humio/humio-helm-charts --namespace humio --set humio-fluentbit.token=$humio_token --values humio-agent.yaml