{"record":{"id":"e37f4bd3c1038bc8","repo":"SigNoz/signoz","slug":"could-not-find-integration-s","errorCode":null,"errorMessage":"could not find integration: %s","messagePattern":"could not find integration: (.+?)","errorType":"http","errorClass":"model.ApiError","httpStatus":404,"severity":"warning","filePath":"pkg/query-service/app/integrations/manager.go","lineNumber":355,"sourceCode":") (*IntegrationDetails, *model.ApiError) {\n\tif len(strings.TrimSpace(integrationId)) < 1 {\n\t\treturn nil, model.BadRequest(fmt.Errorf(\n\t\t\t\"integrationId is required\",\n\t\t))\n\t}\n\n\tais, apiErr := m.availableIntegrationsRepo.get(\n\t\tctx, []string{integrationId},\n\t)\n\tif apiErr != nil {\n\t\treturn nil, model.WrapApiError(apiErr, fmt.Sprintf(\n\t\t\t\"could not fetch integration: %s\", integrationId,\n\t\t))\n\t}\n\n\tintegrationDetails, wasFound := ais[integrationId]\n\tif !wasFound {\n\t\treturn nil, model.NotFoundError(fmt.Errorf(\n\t\t\t\"could not find integration: %s\", integrationId,\n\t\t))\n\t}\n\treturn &integrationDetails, nil\n}\n\nfunc (m *Manager) getInstalledIntegration(\n\tctx context.Context,\n\torgId string,\n\tintegrationId string,\n) (*cloudintegrationtypes.InstalledIntegration, *model.ApiError) {\n\tiis, apiErr := m.installedIntegrationsRepo.get(\n\t\tctx, orgId, []string{integrationId},\n\t)\n\tif apiErr != nil {\n\t\treturn nil, model.WrapApiError(apiErr, fmt.Sprintf(\n\t\t\t\"could not fetch installed integration: %s\", integrationId,\n\t\t))","sourceCodeStart":337,"sourceCodeEnd":373,"githubUrl":"https://github.com/SigNoz/signoz/blob/5069bf80b08f1f00d7e014eccc09902f9871004f/pkg/query-service/app/integrations/manager.go#L337-L373","documentation":"404 Not Found returned by getIntegrationDetails when the requested integration ID was fetched successfully but is not present in the available integrations map — i.e. no such integration exists.","triggerScenarios":"Requesting details, connection tests, or installing an integration ID that is not in the available_integrations repository (typo'd or unknown ID).","commonSituations":"Client uses an integration slug that doesn't exist in this SigNoz version, or available integrations seed data is missing.","solutions":["List available integrations and use an exact ID","Check spelling/case of the integration ID","Verify the available integrations repo/table is populated in your deployment"],"exampleFix":"// before\nGET /api/v1/integrations/prometheas\n\n// after\nGET /api/v1/integrations/prometheus-exporter","handlingStrategy":"validation","validationCode":"const valid = await listIntegrations();\nif (!valid.find(i=>i.id===integrationId)) throw new Error('unknown integration');","typeGuard":null,"tryCatchPattern":"details, apiErr := m.getIntegrationDetails(ctx, id)\nif apiErr != nil && apiErr.Typ == model.ErrorNotFound { /* treat as 404, suggest listing integrations */ }","preventionTips":["Use exact IDs from the integrations catalog","Handle 404 gracefully in clients"],"tags":["integrations","not-found"],"backgroundTag":"resource-not-found","analyzedSha":"5069bf80b08f1f00d7e014eccc09902f9871004f","analyzedAt":"2026-08-28T06:22:12.824Z","schemaVersion":2},"datasetVersion":"2026-08-28T11:17:15.048Z"}