Troubleshooting

common issues and how to work around them.

local vs cloud confusion

if local mode isn't working, the env might still carry cloud credentials. check what the exporter actually sees:

bash

docker compose logs exporter
docker compose exec exporter sh -lc 'echo $QDRANT_URL'
docker compose exec exporter sh -lc 'wget -qO- http://qdrant:6333/collections'

expected for local mode

QDRANT_URL should be http://qdrant:6333
the wget should return json (or at least connect successfully)

docker compose down didn't work

if you see network resource is still in use, kill the container manually:

bash

docker compose ps
docker stop <container-name>
docker compose down

prometheus isn't scraping the exporter

inside docker, prometheus needs to use the service name, not localhost:

localhost inside a prometheus container means the prometheus container itself
the exporter is reachable as http://exporter:9999 on the docker network
open prometheus targets to confirm the scrape is healthy

i can't see the qdrant metrics in prometheus

http://localhost:9091/metrics shows prometheus' own internal metrics — not the exporter's. query names like qdrant_collection_points inside http://localhost:9091/graph instead.

useful commands

bash

docker compose ps
docker compose logs qdrant
docker compose logs exporter
docker compose logs prometheus
docker compose logs grafana

grafana setup

login to grafana (admin / admin)
configuration → data sources → add data source
select prometheus
set url to http://prometheus:9090
click "save & test"
import examples/grafana-dashboard.json from the repo

still stuck?

open an issue on github or drop by the qdrant discord.