Alcor Controller Logging

Alcor Controller Logging

1. Config logging

To configure logging system, modify the following property files:

• src/resource/ application-k8s-template.properties //Kubernetes & cluster setup

• src/resource/application-onebox.properties //Local setup

• Configuration items

  • Logging level – start log level, lower level of logs than this logging level are filtered.

  • Logging level of web

  • logging.type – console or file logging

  • Log file location when logging type is file

  logging.level.root=info
  logging.level.org.springframework.web=info
  logging.file.path=/var/log
  logging.type=file

2. Logging

(1) Import log packages

import com.futurewei.alcor.controller.logging.Logger;
import com.futurewei.alcor.controller.logging.LoggerFactory;

(2) Get logger using logger factory.

Logger logger = LoggerFactory.getLogger();

(3) Call logger.log() wherever logging is needed.

• Function format

  log(Level level, String msg)
  log(Level level, String msg, Object s)
  log(Level level, String msg, Throwable e)
  entering(String sourceClass, String sourceMethod)
  exiting(String sourceClass, String sourceMethod)

• e.g.)

  logger.log(Level.INFO, "Alcor Controller Log Started!");
  logger.exiting(this.getClass().getName(), e.getStatus());
  logger.exiting(this.getClass().getName(), e); 
  logger.entering(this.getClass().getName(),"PushNetworkResourceStates()"); 
  logger.exiting(this.getClass().getName(),"PushNetworkResourceStates()");
  

(4) To see logs using docker,

sudo docker logs  alcor-controller

(5) To see alcor controller logs of kubernetes node,

• Get alcor controller pod name.

  Kubectl get pods
  

• run command

  kubectl exec my-pod -c my-container -- ls /var/log

• e.g.)

  kubectl exec alcor-5c9746c7b9-fmg2s  --  ls  /var/log
  kubectl exec alcor-5c9746c7b9-fmg2s -c alcor -- cat /var/log/AlcorLog-2020-02-10.log