{"record":{"id":"ca83ac1354efa9c3","repo":"SigNoz/signoz","slug":"codeinternal-ca83ac","errorCode":"CodeInternal","errorMessage":"unable to fetch license data with upstream server","messagePattern":"unable to fetch license data with upstream server","errorType":"error_code","errorClass":null,"httpStatus":500,"severity":"error","filePath":"ee/licensing/httplicensing/provider.go","lineNumber":101,"sourceCode":"\torganizations, err := provider.orgGetter.ListByOwnedKeyRange(ctx)\n\tif err != nil {\n\t\treturn err\n\t}\n\n\tfor _, organization := range organizations {\n\t\terr := provider.Refresh(ctx, organization.ID)\n\t\tif err != nil {\n\t\t\treturn err\n\t\t}\n\t}\n\n\treturn nil\n}\n\nfunc (provider *provider) Activate(ctx context.Context, organizationID valuer.UUID, key string) error {\n\tdata, err := provider.zeus.GetLicense(ctx, key)\n\tif err != nil {\n\t\treturn errors.Wrapf(err, errors.TypeInternal, errors.CodeInternal, \"unable to fetch license data with upstream server\")\n\t}\n\n\tlicense, err := licensetypes.NewLicense(data, organizationID)\n\tif err != nil {\n\t\treturn errors.Wrapf(err, errors.TypeInternal, errors.CodeInternal, \"failed to create license entity\")\n\t}\n\n\tstorableLicense := licensetypes.NewStorableLicenseFromLicense(license)\n\terr = provider.store.Create(ctx, storableLicense)\n\tif err != nil {\n\t\treturn err\n\t}\n\n\treturn nil\n}\n\nfunc (provider *provider) GetActive(ctx context.Context, organizationID valuer.UUID) (*licensetypes.License, error) {\n\tstorableLicenses, err := provider.store.GetAll(ctx, organizationID)","sourceCodeStart":83,"sourceCodeEnd":119,"githubUrl":"https://github.com/SigNoz/signoz/blob/5069bf80b08f1f00d7e014eccc09902f9871004f/ee/licensing/httplicensing/provider.go#L83-L119","documentation":"SigNoz EE licensing Activate() calls the upstream Zeus license server (GetLicense); any upstream failure is wrapped as CodeInternal with this message.","triggerScenarios":"POST /api/v1/activate (or programmatic licensing.Activate) with a valid-format key while the Zeus server is unreachable, returns 5xx, TLS fails, or the response cannot be retrieved.","commonSituations":"Egress firewall blocking calls to the SigNoz licensing endpoint; DNS/proxy issues in air-gapped or on-prem deployments; Zeus outage; expired server TLS certs; retry after network partition.","solutions":["Restore outbound connectivity to the SigNoz licensing (Zeus) endpoint from the signoz service","Check proxy/HTTP_PROXY env vars and DNS resolution inside the container","Retry activation once network is confirmed healthy (transient 5xx)","Inspect the wrapped cause error for HTTP status/TLS details and contact SigNoz support if upstream persists"],"exampleFix":null,"handlingStrategy":"retry","validationCode":null,"typeGuard":null,"tryCatchPattern":"err := licensing.Activate(ctx, orgID, key)\nif err != nil {\n\tif errors.Ast(err, errors.CodeInternal) && strings.Contains(err.Error(), \"upstream\") { backoff.Retry(activate, 3) }\n}","preventionTips":["Allow egress to the SigNoz licensing domain from the signoz deployment","Configure proxy env vars for air-gapped setups","Surface the wrapped cause in logs for diagnosis"],"tags":["signoz","licensing","network","upstream","activation"],"backgroundTag":"upstream-service-unreachable","analyzedSha":"5069bf80b08f1f00d7e014eccc09902f9871004f","analyzedAt":"2026-08-28T06:22:12.824Z","schemaVersion":2},"datasetVersion":"2026-08-28T11:17:15.048Z"}