Debugging Connect

Find Axual-Connect’s configuration

The effective configuration of Axual-Connect can be seen by inspecting the connect-pods in kubernetes.
You can do that via k9s or kubectl.
Make sure that your kubectl uses the correct context.

kubectl -n kafka describe deployment axual-local-axual-connect

The configuration of the helm-charts are in the values.yaml file that you used to deploy the helm chart.

Acquire Axual-Connect’s Logs

The most recent logs can be seen by using k9s or command line:

kubectl -n kafka logs -f --tail 2000 deployment/axual-local-axual-connect

Historical logging is not kept when deploying the platform via helm.
You are encouraged to configure a central logging system and configure it to scrape Axual-Connect logs, too.

Check Axual-Connect’s API endpoint

The port on which the API is hosted can be seen via k9s or kubectl.

kubectl -n kafka describe service axual-local-connect

The port is configurable in values.yaml.

You can hit the service endpoint from inside any container in the same k8s namespace.
The recommended way, if possible, is to port-forward the endpoint from a Connect Pod and check the API in your browser.

Debugging

Now that you know how to check the configuration, logs and the API, you can debug connect.
Note that runtime configuration, such as customer connect-application definitions, are stored in the MGMT-API database.

The "AOM" (axual operations manager) is a middle-man between MGMT-API and Connect.
Sometimes it’s worth checking the AOM logs, as well.

As we’ll identify common problems, we’ll list them here.

  • Connect-Application certificate files must be saved using Linux/Unix line breaks, not Windows Line Feeds.
    Please do not alter the certificate using standard Windows tools as this can cause corruption.