SigNoz/signoz · error · errors.SignozError

CodeInternal

CodeInternal

Error message

checkErr.GetMessage()

What it means

Returned by BatchCheck when OpenFGA returns a CheckError that is not an InputError (default branch); it is surfaced as an internal error with OpenFGA's message. Indicates a server-side or unexpected failure during the check evaluation rather than bad caller input.

Source

Thrown at pkg/authz/openfgaserver/server.go:428

}

func (server *Server) getStoreIDandModelID() (string, string) {
	server.mtx.RLock()
	defer server.mtx.RUnlock()

	storeID := server.storeID
	modelID := server.modelID

	return storeID, modelID
}

func (server *Server) getCheckError(checkErr *openfgav1.CheckError) error {
	switch checkErr.GetCode().(type) {
	case *openfgav1.CheckError_InputError:
		return errors.New(errors.TypeInvalidInput, errors.CodeInvalidInput, checkErr.GetMessage())
	default:
		return errors.New(errors.TypeInternal, errors.CodeInternal, checkErr.GetMessage())
	}
}

View on GitHub (pinned to 5069bf80b0)

Solutions

  1. Check OpenFGA server logs for the evaluation failure and its store/model ids
  2. Verify the store id and authorization model id in use are valid and current
  3. Upgrade/align openfga client and server versions; retry transiently with backoff
Defensive patterns

Strategy: retry

Try / catch

err := server.BatchCheck(ctx, req)
if err != nil {
    if isInternalErr(err) { // TypeInternal from getCheckError
        return retryWithBackoff(ctx, func() error { return server.BatchCheck(ctx, req) })
    }
    return err
}

Prevention

When it happens

Trigger: Calling BatchCheck when OpenFGA returns a non-input CheckError — e.g. store/model resolution failure, server-side evaluation error, context deadline during checks.

Common situations: OpenFGA pointing at a deleted store or stale authorization model id; OpenFGA under heavy load timing out; version skew between the openfga client library and server.

Related errors

AI-assisted analysis of SigNoz/signoz@5069bf80b0 (2026-08-28). Data as JSON: /api/errors/a532c9e9a4ed3f53. Report an issue: GitHub.