Package com.langfuse.client.resources.observationsv2.requests

Class GetObservationsV2Request.Builder

java.lang.Object

com.langfuse.client.resources.observationsv2.requests.GetObservationsV2Request.Builder

Enclosing class:

GetObservationsV2Request

public static final class GetObservationsV2Request.Builder
extends Object

Method Summary

Modifier and Type	Method	Description
GetObservationsV2Request.Builder	additionalProperties(Map<String,Object> additionalProperties)
GetObservationsV2Request.Builder	additionalProperty(String key, Object value)
GetObservationsV2Request	build()
GetObservationsV2Request.Builder	cursor(String cursor)
GetObservationsV2Request.Builder	cursor(Optional<String> cursor)	Base64-encoded cursor for pagination.
GetObservationsV2Request.Builder	environment(String environment)
GetObservationsV2Request.Builder	environment(List<String> environment)
GetObservationsV2Request.Builder	environment(Optional<List<String>> environment)	Optional filter for observations where the environment is one of the provided values.
GetObservationsV2Request.Builder	expandMetadata(String expandMetadata)
GetObservationsV2Request.Builder	expandMetadata(Optional<String> expandMetadata)	Comma-separated list of metadata keys to return non-truncated.
GetObservationsV2Request.Builder	fields(String fields)
GetObservationsV2Request.Builder	fields(Optional<String> fields)	Comma-separated list of field groups to include in the response.
GetObservationsV2Request.Builder	filter(String filter)
GetObservationsV2Request.Builder	filter(Optional<String> filter)	JSON string containing an array of filter conditions.
GetObservationsV2Request.Builder	from(GetObservationsV2Request other)
GetObservationsV2Request.Builder	fromStartTime(OffsetDateTime fromStartTime)
GetObservationsV2Request.Builder	fromStartTime(Optional<OffsetDateTime> fromStartTime)	Retrieve only observations with a start_time on or after this datetime (ISO 8601).
GetObservationsV2Request.Builder	level(ObservationLevel level)
GetObservationsV2Request.Builder	level(Optional<ObservationLevel> level)	Optional filter for observations with a specific level (e.g.
GetObservationsV2Request.Builder	limit(Integer limit)
GetObservationsV2Request.Builder	limit(Optional<Integer> limit)	Number of items to return per page.
GetObservationsV2Request.Builder	name(String name)
GetObservationsV2Request.Builder	name(Optional<String> name)
GetObservationsV2Request.Builder	parentObservationId(String parentObservationId)
GetObservationsV2Request.Builder	parentObservationId(Optional<String> parentObservationId)
GetObservationsV2Request.Builder	parseIoAsJson(Boolean parseIoAsJson)
GetObservationsV2Request.Builder	parseIoAsJson(Optional<Boolean> parseIoAsJson)	Deprecated. Setting this to true will return a 400 error.
GetObservationsV2Request.Builder	toStartTime(OffsetDateTime toStartTime)
GetObservationsV2Request.Builder	toStartTime(Optional<OffsetDateTime> toStartTime)	Retrieve only observations with a start_time before this datetime (ISO 8601).
GetObservationsV2Request.Builder	traceId(String traceId)
GetObservationsV2Request.Builder	traceId(Optional<String> traceId)
GetObservationsV2Request.Builder	type(String type)
GetObservationsV2Request.Builder	type(Optional<String> type)	Filter by observation type (e.g., "GENERATION", "SPAN", "EVENT", "AGENT", "TOOL", "CHAIN", "RETRIEVER", "EVALUATOR", "EMBEDDING", "GUARDRAIL")
GetObservationsV2Request.Builder	userId(String userId)
GetObservationsV2Request.Builder	userId(Optional<String> userId)
GetObservationsV2Request.Builder	version(String version)
GetObservationsV2Request.Builder	version(Optional<String> version)	Optional filter to only include observations with a certain version.

Methods inherited from class java.lang.Object

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

Method Details

from

public GetObservationsV2Request.Builder from(GetObservationsV2Request other)

environment

public GetObservationsV2Request.Builder environment(Optional<List<String>> environment)

Optional filter for observations where the environment is one of the provided values.

environment

public GetObservationsV2Request.Builder environment(List<String> environment)

environment

public GetObservationsV2Request.Builder environment(String environment)

fields

public GetObservationsV2Request.Builder fields(Optional<String> fields)

Comma-separated list of field groups to include in the response. Available groups: core, basic, time, io, metadata, model, usage, prompt, metrics. If not specified, core and basic field groups are returned. Example: "basic,usage,model"

fields

public GetObservationsV2Request.Builder fields(String fields)

expandMetadata

public GetObservationsV2Request.Builder expandMetadata(Optional<String> expandMetadata)

Comma-separated list of metadata keys to return non-truncated. By default, metadata values over 200 characters are truncated. Use this parameter to retrieve full values for specific keys. Example: "key1,key2"

expandMetadata

public GetObservationsV2Request.Builder expandMetadata(String expandMetadata)

limit

public GetObservationsV2Request.Builder limit(Optional<Integer> limit)

Number of items to return per page. Maximum 1000, default 50.

limit

public GetObservationsV2Request.Builder limit(Integer limit)

cursor

public GetObservationsV2Request.Builder cursor(Optional<String> cursor)

Base64-encoded cursor for pagination. Use the cursor from the previous response to get the next page.

cursor

public GetObservationsV2Request.Builder cursor(String cursor)

parseIoAsJson

public GetObservationsV2Request.Builder parseIoAsJson(Optional<Boolean> parseIoAsJson)

Deprecated. Setting this to true will return a 400 error. Input/output fields are always returned as raw strings. Remove this parameter or set it to false.

parseIoAsJson

public GetObservationsV2Request.Builder parseIoAsJson(Boolean parseIoAsJson)

name

public GetObservationsV2Request.Builder name(Optional<String> name)

name

public GetObservationsV2Request.Builder name(String name)

userId

public GetObservationsV2Request.Builder userId(Optional<String> userId)

userId

public GetObservationsV2Request.Builder userId(String userId)

type

public GetObservationsV2Request.Builder type(Optional<String> type)

Filter by observation type (e.g., "GENERATION", "SPAN", "EVENT", "AGENT", "TOOL", "CHAIN", "RETRIEVER", "EVALUATOR", "EMBEDDING", "GUARDRAIL")

type

public GetObservationsV2Request.Builder type(String type)

traceId

public GetObservationsV2Request.Builder traceId(Optional<String> traceId)

traceId

public GetObservationsV2Request.Builder traceId(String traceId)

level

public GetObservationsV2Request.Builder level(Optional<ObservationLevel> level)

Optional filter for observations with a specific level (e.g. "DEBUG", "DEFAULT", "WARNING", "ERROR").

level

public GetObservationsV2Request.Builder level(ObservationLevel level)

parentObservationId

public GetObservationsV2Request.Builder parentObservationId(Optional<String> parentObservationId)

parentObservationId

public GetObservationsV2Request.Builder parentObservationId(String parentObservationId)

fromStartTime

public GetObservationsV2Request.Builder fromStartTime(Optional<OffsetDateTime> fromStartTime)

Retrieve only observations with a start_time on or after this datetime (ISO 8601).

fromStartTime

public GetObservationsV2Request.Builder fromStartTime(OffsetDateTime fromStartTime)

toStartTime

public GetObservationsV2Request.Builder toStartTime(Optional<OffsetDateTime> toStartTime)

Retrieve only observations with a start_time before this datetime (ISO 8601).

toStartTime

public GetObservationsV2Request.Builder toStartTime(OffsetDateTime toStartTime)

version

public GetObservationsV2Request.Builder version(Optional<String> version)

Optional filter to only include observations with a certain version.

version

public GetObservationsV2Request.Builder version(String version)

filter

public GetObservationsV2Request.Builder filter(Optional<String> filter)

JSON string containing an array of filter conditions. When provided, this takes precedence over query parameter filters (userId, name, type, level, environment, fromStartTime, ...).

filter

public GetObservationsV2Request.Builder filter(String filter)

build

public GetObservationsV2Request build()

additionalProperty

public GetObservationsV2Request.Builder additionalProperty(String key,
 Object value)

additionalProperties

public GetObservationsV2Request.Builder additionalProperties(Map<String,Object> additionalProperties)