{"record":{"id":"699dd55cf87fe944","repo":"Mintplex-Labs/anything-llm","slug":"qdrant-invalid-heartbeat-received-is-the-instan","errorCode":null,"errorMessage":"QDrant::Invalid Heartbeat received - is the instance online?","messagePattern":"QDrant::Invalid Heartbeat received - is the instance online\\?","errorType":"exception","errorClass":null,"httpStatus":null,"severity":"error","filePath":"server/utils/vectorDbProviders/qdrant/index.js","lineNumber":32,"sourceCode":"\n  get name() {\n    return \"QDrant\";\n  }\n\n  async connect() {\n    if (process.env.VECTOR_DB !== \"qdrant\")\n      throw new Error(\"QDrant::Invalid ENV settings\");\n\n    const client = new QdrantClient({\n      url: process.env.QDRANT_ENDPOINT,\n      ...(process.env.QDRANT_API_KEY\n        ? { apiKey: process.env.QDRANT_API_KEY }\n        : {}),\n    });\n\n    const isAlive = (await client.api(\"cluster\")?.clusterStatus())?.ok || false;\n    if (!isAlive)\n      throw new Error(\n        \"QDrant::Invalid Heartbeat received - is the instance online?\"\n      );\n\n    return { client };\n  }\n\n  async heartbeat() {\n    await this.connect();\n    return { heartbeat: Number(new Date()) };\n  }\n\n  async totalVectors() {\n    const { client } = await this.connect();\n    const { collections } = await client.getCollections();\n    var totalVectors = 0;\n    for (const collection of collections) {\n      if (!collection || !collection.name) continue;\n      totalVectors +=","sourceCodeStart":14,"sourceCodeEnd":50,"githubUrl":"https://github.com/Mintplex-Labs/anything-llm/blob/3aec848f2885144aa8f1e53b9731a04310d5d558/server/utils/vectorDbProviders/qdrant/index.js#L14-L50","documentation":"Health check failure in QDrant.connect(): a QdrantClient was created from QDRANT_ENDPOINT but the cluster status API did not report ok, meaning the QDrant instance is unreachable, starting up, or the endpoint/API key is wrong.","triggerScenarios":"The QDrant heartbeat check failed; the instance appears offline.","commonSituations":"This error is raised at runtime in server/utils/vectorDbProviders/qdrant/index.js. It occurs when the required configuration for this provider is missing or invalid (unset environment variables, empty API key or base path), when the external service is unreachable or returns an unexpected response, or when invalid input reaches the call site. To prevent it, validate the relevant provider settings and environment variables at startup and confirm the service is reachable before this code path executes.","solutions":["Check that the QDrant instance is running and reachable.","Verify the QDrant endpoint URL and API key."],"exampleFix":null,"handlingStrategy":"retry","validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"backgroundTag":null,"analyzedSha":"3aec848f2885144aa8f1e53b9731a04310d5d558","analyzedAt":"2026-08-18T10:02:21.017Z","contentChangedAt":"2026-08-18T10:02:21.017Z","schemaVersion":2},"datasetVersion":"2026-09-14T05:17:10.506Z"}