Files
LocalAI/pkg/grpc/grpcerrors/errors_test.go
Adira 4ec39bb776 fix(watchdog): don't log optional Free() as an error when backend returns Unimplemented (#10602) (#10607)
* fix(watchdog): don't log optional Free() as an error when backend returns Unimplemented (#10602)

When the watchdog evicts a model, deleteProcess calls the backend's gRPC
Free() to release VRAM before stopping the process. Free is optional:
backends that don't override it -- the generated UnimplementedBackendServer
stub, many Python/external backends, or a federation proxy in distributed
mode -- return gRPC Unimplemented. That is expected, not a failure: VRAM is
reclaimed when the local process is stopped, or by the remote unloader for
remote backends. Logging it as "WARN Error freeing GPU resources" made a
benign, optional RPC look like a fault (the alarming line in #10602, seen
in distributed mode where the model is remote and Free hits a stub).

Treat gRPC Unimplemented from Free() as a no-op logged at Debug; genuine
failures still Warn. Free() is still attempted for every backend, so any
backend that does implement it is unaffected.

Add a reusable grpcerrors.IsUnimplemented helper following the package's
existing code-based detection idiom (prefer the typed status code, fall
back to the message across non-gRPC boundaries), with table tests.

Assisted-by: Claude:claude-opus-4-8 [Claude Code]

Signed-off-by: Adira Denis Muhando <dennisadira@gmail.com>

* fix(watchdog): log a non-Unimplemented Free() failure at error level

Per review: now that the expected gRPC Unimplemented case is split out and
logged at Debug, any remaining Free() error is a genuine failure to release
VRAM, so surface it at error level instead of warn.

Assisted-by: Claude:claude-opus-4-8 [Claude Code]

Signed-off-by: Adira Denis Muhando <dennisadira@gmail.com>

---------

Signed-off-by: Adira Denis Muhando <dennisadira@gmail.com>
2026-06-30 22:14:01 +02:00

76 lines
3.2 KiB
Go

package grpcerrors_test
import (
"errors"
"testing"
. "github.com/onsi/ginkgo/v2"
. "github.com/onsi/gomega"
"github.com/mudler/LocalAI/pkg/grpc/grpcerrors"
"google.golang.org/grpc/codes"
"google.golang.org/grpc/status"
)
func TestGRPCErrors(t *testing.T) {
RegisterFailHandler(Fail)
RunSpecs(t, "grpcerrors test suite")
}
var _ = Describe("grpcerrors", func() {
DescribeTable("IsModelNotLoaded",
func(err error, want bool) {
Expect(grpcerrors.IsModelNotLoaded(err)).To(Equal(want))
},
Entry("nil", nil, false),
Entry("typed via constructor", grpcerrors.ModelNotLoaded("parakeet-cpp"), true),
Entry("typed code only", status.Error(codes.FailedPrecondition, "anything"), true),
Entry("legacy message (Unknown code)", errors.New("parakeet-cpp: model not loaded"), true),
Entry("legacy message mixed case", errors.New("Backend: Model Not Loaded"), true),
Entry("unrelated error", errors.New("context deadline exceeded"), false),
Entry("unrelated grpc code", status.Error(codes.Unavailable, "connection refused"), false),
)
It("ModelNotLoaded carries FailedPrecondition", func() {
Expect(status.Code(grpcerrors.ModelNotLoaded("whisper"))).To(Equal(codes.FailedPrecondition))
})
DescribeTable("IsLiveTranscriptionUnsupported",
func(err error, want bool) {
Expect(grpcerrors.IsLiveTranscriptionUnsupported(err)).To(Equal(want))
},
Entry("nil", nil, false),
Entry("typed via constructor", grpcerrors.LiveTranscriptionUnsupported("parakeet-cpp", "not a streaming model"), true),
Entry("typed code only", status.Error(codes.Unimplemented, "anything"), true),
Entry("stale stub message (Unknown code)", errors.New("rpc error: method AudioTranscriptionLive unimplemented"), true),
Entry("unrelated error", errors.New("context deadline exceeded"), false),
Entry("model not loaded is NOT unsupported", grpcerrors.ModelNotLoaded("parakeet-cpp"), false),
)
It("LiveTranscriptionUnsupported carries Unimplemented, not FailedPrecondition", func() {
err := grpcerrors.LiveTranscriptionUnsupported("parakeet-cpp", "reason")
Expect(status.Code(err)).To(Equal(codes.Unimplemented))
// FailedPrecondition is claimed by IsModelNotLoaded — the two
// signals must never alias.
Expect(grpcerrors.IsModelNotLoaded(err)).To(BeFalse())
})
DescribeTable("IsUnimplemented",
func(err error, want bool) {
Expect(grpcerrors.IsUnimplemented(err)).To(Equal(want))
},
Entry("nil", nil, false),
Entry("typed code", status.Error(codes.Unimplemented, "method Free not implemented"), true),
Entry("stale stub message (Unknown code)", errors.New("rpc error: code = Unimplemented desc = "), true),
Entry("unrelated error", errors.New("context deadline exceeded"), false),
Entry("unrelated grpc code", status.Error(codes.Unavailable, "connection refused"), false),
Entry("model not loaded is NOT unimplemented", grpcerrors.ModelNotLoaded("parakeet-cpp"), false),
)
It("StreamTranscriptionUnsupported carries Unimplemented and is not ModelNotLoaded", func() {
err := grpcerrors.StreamTranscriptionUnsupported("parakeet-cpp", "not a streaming model")
Expect(status.Code(err)).To(Equal(codes.Unimplemented))
Expect(grpcerrors.IsModelNotLoaded(err)).To(BeFalse())
})
})