Change EMQX Log Level

Objective

Modify the log level in the EMQX cluster.

Configure EMQX Cluster

EMQX CRD apps.emqx.io/v2beta1 supports configuring the log level of the EMQX cluster through .spec.config.data. Refer to the Configuration Manual for complete configuration reference.

1. Save the following content as a YAML file and deploy it using kubectl apply:

apiVersion: apps.emqx.io/v2beta1
kind: EMQX
metadata:
  name: emqx
spec:
  image: emqx/emqx:6.0.1
  config:
    # Enable debug logging:
    data: |
      log.console.level = debug
      license {
        key = "..."
      }
  dashboardServiceTemplate:
    spec:
      type: LoadBalancer
  listenersServiceTemplate:
    spec:
      type: LoadBalancer

2. Wait for the EMQX cluster to become ready.

Check the status of the EMQX cluster with kubectl get and ensure that STATUS is Ready. This may take some time.

$ kubectl get emqx
NAME   STATUS   AGE
emqx   Ready    10m

Verify Log Level

1. Obtain the External IP of the EMQX cluster.

external_ip=$(kubectl get svc emqx-listeners -o json | jq '.status.loadBalancer.ingress[0].ip')

2. Use MQTTX CLI to connect to the EMQX cluster.

MQTTX CLI is an open source MQTT 5.0 command line client tool, designed to help developers start using MQTT services and applications more quickly.

$ mqttx conn -h ${external_ip} -p 1883
[4/17/2023] [5:17:31 PM] › … Connecting...
[4/17/2023] [5:17:31 PM] › ✔ Connected

3. View EMQX container logs.

$ kubectl logs emqx-core-0 -c emqx
...
2023-04-17T09:11:35.993031+00:00 [debug] msg: mqtt_packet_received, mfa: emqx_channel:handle_in/2, line: 360, peername: 218.190.230.144:59457, clientid: mqttx_322680d9, packet: CONNECT(Q0, R0, D0, ClientId=mqttx_322680d9, ProtoName=MQTT, ProtoVsn=5, CleanStart=true, KeepAlive=30, Username=undefined, Password=), tag: MQTT
2023-04-17T09:11:35.997066+00:00 [debug] msg: mqtt_packet_sent, mfa: emqx_connection:serialize_and_inc_stats_fun/1, line: 872, peername: 218.190.230.144:59457, clientid: mqttx_322680d9, packet: CONNACK(Q0, R0, D0, AckFlags=0, ReasonCode=0), tag: MQTT