Many of our customers choose to run the Cortex application in a self-hosted environment. In some cases, backend application logs are needed to support troubleshooting efforts. To simplify the process of collecting and packaging these logs, you can use either standard Kubernetes tools or Cortex's built-in tooling.
Using kubectl:
You can use the kubectl logs command to export deployment logs with timestamps:
kubectl logs deployment/cortex-worker -n <namespace>
Using Brain Freeze CLI:
The Brain Freeze CLI provides comprehensive log collection capabilities:
Once installed, you can use brain-freeze k8s logs [options] to fetch the logs for all Cortex related deployments.
You can use brain-freeze k8s dump [options] to dump all installation information.
Post-installation, to provide Cortex with your setup configurations, you can use /brain-freeze
backend info --token="[CORTEX PAT]" --url="[BACKEND HOST]" to get this information. Cortex PATs can be created in Settings -> Personal access tokens in the app.
All commands create a data folder that can be uploaded to a support ticket which will contain the data needed for the Cortex team to debug the issue.
To view other debugging methods available with Brain Freeze, visit our Debugging documentation.