Skip to content
ArtificialFlow

Troubleshooting

Start with the rendered config, then identity, then the connector. A healthy process only means it started.

Compose config

From a checkout, make smoke renders docker-compose.yml and checks the Kafka wiring without starting containers. For a file from the deploy builder:

docker compose -f artificialflow.compose.yml config --quiet
docker compose -f artificialflow.compose.yml ps
docker compose -f artificialflow.compose.yml logs
  • The generated file needs Compose v2.23 or newer because the gateway config is embedded with configs.content.
  • IAM_DEPLOYMENT_MODE must be true or false. external and disabled fail startup and name the allowed values.
  • With true, the issuer URLs, AUTH_CLIENT_ID, and AUTH_CLAIM_ROLES_PATH are required. AUTH_PRODUCTION=true refuses to start with false.
  • Elasticsearch needs memory and a minute on first boot. Command and runtime apply migrations before they are ready. Read their logs for a checksum mismatch. Do not edit an applied migration.
  • make up-release on a development branch can start images that do not match that branch. Use make up, or check out the release branch.
  • If the command API is up and the connector is missing, make init-connector is the recovery step.

Cannot sign in

  • With IAM_DEPLOYMENT_MODE=false, use admin / admin, or the CONSOLE_ADMIN_USERNAME and CONSOLE_ADMIN_PASSWORD you set.
  • With true, compare the browser issuer, the internal issuer, the frontend client id, and the redirect origin with IAM and roles.

Query results are empty

  • curl -fsS http://localhost:8092/health for the sync worker.
  • Kafka topics exist and have consumers.
  • The Debezium connector and its tasks are RUNNING at http://localhost:8083/connectors/artificialflow-postgres-connector/status.
  • Elasticsearch is reachable. Then run make cqrs-e2e-smoke from a checkout.

SDK calls are unauthorized

  • The machine client has only artificialflowclient, and the role claim matches AUTH_CLAIM_ROLES_PATH.
  • Send the raw access token. The clients add the Bearer prefix.
  • In JWT mode the token issuer matches AUTH_ISSUER_PUBLIC_URL. In introspection mode the endpoint returns active=true, a subject, the audience, and the role.

Helm

helm lint ./charts/artificialflow
helm template artificialflow ./charts/artificialflow
helm template artificialflow ./charts/artificialflow -f ./charts/artificialflow/values-kind-smoke.yaml
  • iam.mode is the boolean true or false, not the string external, disabled, or a --set-string value.
  • Remove leftover migration.* values. The chart refuses to render them.
  • A long migration that hits the startup probe needs a larger startupProbe.failureThreshold. Old pods keep serving until the new pods are ready.