Class ObservabilityListeners

java.lang.Object

dev.langchain4j.internal.ObservabilityListeners

public final class ObservabilityListeners
extends Object

Adds the listeners of the ObservabilityListenersProviders found with ServiceLoader to AI Services and to model calls. The providers are looked up once, in the class loader of LangChain4j. A framework that loads the application with class loaders of its own (for example Quarkus) finds the providers of those class loaders with load(ClassLoader) and passes them to useFrameworkProviders(List). Only providers of LangChain4j itself (classes in dev.langchain4j packages) are used: they receive the content of every model call, so a provider of another library on the classpath is logged and skipped. A provider that cannot be loaded, or whose listeners cannot be obtained, is logged and skipped: it never breaks an AI Service or a model call.

Method Summary

Modifier and Type	Method	Description
static List<ChatModelListener>	chat(List<ChatModelListener> listeners)
static List<DecisionModelListener>	decision(List<DecisionModelListener> listeners)
static List<EmbeddingModelListener>	embedding(List<EmbeddingModelListener> listeners)
static List<ObservabilityListenersProvider>	load(ClassLoader classLoader)	Loads the providers found with ServiceLoader in the given class loader, each time it is called.
static List<ModerationModelListener>	moderation(List<ModerationModelListener> listeners)
static void	registerWith(AiServiceListenerRegistrar registrar)	Registers the provided AI Service listeners with the given registrar, once per registrar, so that a registrar shared by several AI Services does not receive the same listener several times.
static List<ScoringModelListener>	scoring(List<ScoringModelListener> listeners)
static void	useFrameworkProviders(List<ObservabilityListenersProvider> frameworkProviders)	Uses the given providers, found by a framework in the class loaders of the application (see load(ClassLoader)), in addition to the providers of LangChain4j's own class loader.

Methods inherited from class Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Details

registerWith

public static void registerWith(AiServiceListenerRegistrar registrar)

Registers the provided AI Service listeners with the given registrar, once per registrar, so that a registrar shared by several AI Services does not receive the same listener several times.

chat

public static List<ChatModelListener> chat(List<ChatModelListener> listeners)

embedding

public static List<EmbeddingModelListener> embedding(List<EmbeddingModelListener> listeners)

moderation

public static List<ModerationModelListener> moderation(List<ModerationModelListener> listeners)

scoring

public static List<ScoringModelListener> scoring(List<ScoringModelListener> listeners)

decision

public static List<DecisionModelListener> decision(List<DecisionModelListener> listeners)

useFrameworkProviders

public static void useFrameworkProviders(List<ObservabilityListenersProvider> frameworkProviders)

Uses the given providers, found by a framework in the class loaders of the application (see load(ClassLoader)), in addition to the providers of LangChain4j's own class loader. They replace the providers given before: a framework calls this method each time it starts the application, and with an empty list when it stops it. A provider class found in both is used once, from the framework's providers.

load

public static List<ObservabilityListenersProvider> load(ClassLoader classLoader)

Loads the providers found with ServiceLoader in the given class loader, each time it is called. Only providers of LangChain4j are returned; a provider that cannot be loaded is logged and skipped.