Storyteller VAST Module Documentation/com.storyteller.modules.vast.observability/VastObservabilityEvent

VastObservabilityEvent

Structured diagnostics events emitted by the VAST module pipeline (vast.* namespace).

Exposed publicly as part of com.storyteller.modules.vast.StorytellerVastModule.diagnostics so host apps (e.g. the DevZone developer surface) can observe pipeline health. All URL-bearing fields pass through UrlRedactor before being emitted on the diagnostics flow, so advertising identifiers never reach subscribers.

Treat this surface as semi-stable: structural additions are non-breaking, removals and field renames are reserved for minor-version releases.

Inheritors

Types

MediaSelectFailed

data class MediaSelectFailed(val slotId: String, val availableMimes: List<String>, val candidateCount: Int) : VastObservabilityEvent

Emitted when VAST media files exist but none are playable by the module.

ParseFailed

data class ParseFailed(val slotId: String, val cause: String) : VastObservabilityEvent

Emitted when VAST XML cannot be parsed.

RequestCompleted

data class RequestCompleted(val slotId: String, val totalMs: Long, val vastVersion: String, val adCount: Int, val wrapperDepth: Int) : VastObservabilityEvent

Emitted after a VAST response is fetched, parsed, and mapped successfully.

RequestFailed

data class RequestFailed(val slotId: String, val errorType: String, val errorCode: Int, val totalMs: Long, val httpStatus: Int? = null) : VastObservabilityEvent

Emitted when request construction, network loading, wrapper resolution, or mapping fails.

RequestStarted

data class RequestStarted(val slotId: String, val baseUrl: String, val urlFormat: UrlFormat, val paramCount: Int) : VastObservabilityEvent

Emitted before the module performs a VAST HTTP request.

WrapperResolved

data class WrapperResolved(val slotId: String, val depth: Int, val totalMs: Long) : VastObservabilityEvent

Emitted after wrapper traversal resolves to an inline response.

Properties

slotId

abstract val slotId: String

SDK ad slot identifier associated with the event.