Files
LocalAI/core/services/failover/classify.go
T
Ettore Di Giacinto 6df1767133 fix(localai-proxy): keep rerank, stream errors and chat intact through the proxy
Rerank no longer sends top_n 0, which the upstream rejects. A
mid-stream upstream error frame now fails the call instead of ending
it as a short success. Temperature 0 is forwarded. An upstream 429
becomes ResourceExhausted, which failover skips like Unimplemented.

A localai-proxy config sends its own name upstream when upstream_model
is unset, and a chat proxy defaults to the tokenizer template so chat
reaches the upstream as messages.

Assisted-by: Claude:claude-opus-5-5
Signed-off-by: Ettore Di Giacinto <mudler@localai.io>
2026-09-27 07:42:21 +00:00

97 lines
2.5 KiB
Go

package failover
import (
"context"
"errors"
"net/http"
"regexp"
"strconv"
"strings"
"github.com/labstack/echo/v4"
"google.golang.org/grpc/codes"
grpcstatus "google.golang.org/grpc/status"
)
// cloud-proxy translate mode reports upstream failures as plain text, so the
// status is only visible in the message.
var upstreamStatusRe = regexp.MustCompile(`upstream (\d{3})`)
// Errors that the next target would reject in the same way.
var requestErrorMarkers = []string{
"exceeds the available context size",
"is larger than the max context size",
"maximum context length",
}
// IsRetryable reports whether a failed attempt should move to the next
// target. status is the HTTP status a handler wrote, or 0 when it returned err
// without writing.
func IsRetryable(err error, status int) bool {
if errors.Is(err, context.Canceled) {
return false
}
if status != 0 {
return retryableStatus(status)
}
if err == nil {
return false
}
var he *echo.HTTPError
if errors.As(err, &he) {
return retryableStatus(he.Code)
}
if errors.Is(err, context.DeadlineExceeded) {
return true
}
if st, ok := grpcstatus.FromError(err); ok {
switch st.Code() {
case codes.Unavailable, codes.Internal, codes.DeadlineExceeded, codes.Unknown:
return !isRequestError(st.Message())
default:
return false
}
}
msg := err.Error()
if m := upstreamStatusRe.FindStringSubmatch(msg); m != nil {
code, _ := strconv.Atoi(m[1])
return retryableStatus(code)
}
// Anything else is usually a dial or load failure of this target.
return !isRequestError(msg)
}
// IsCapabilityGap reports a target that cannot serve this request right now
// for a reason that says nothing about its health: it cannot serve this kind
// of request at all (gRPC Unimplemented), or it is out of capacity, such as a
// rate-limited upstream (gRPC ResourceExhausted, what localai-proxy returns
// for an upstream 429). Matched anywhere in the error chain. The next target
// may serve it, so callers must skip this one without tripping it.
func IsCapabilityGap(err error) bool {
if err == nil {
return false
}
st, ok := grpcstatus.FromError(err)
if !ok {
return false
}
switch st.Code() {
case codes.Unimplemented, codes.ResourceExhausted:
return true
}
return false
}
func retryableStatus(code int) bool {
return code >= 500 && code != http.StatusNotImplemented
}
func isRequestError(msg string) bool {
for _, m := range requestErrorMarkers {
if strings.Contains(msg, m) {
return true
}
}
return false
}