Struct NativeInstrumentation 

pub struct NativeInstrumentation { /* private fields */ }

Embedding-only access to the instrumentation hub owned by one live Runtime.

The service retains only a weak Runtime identity. It is never a Hara value, is not installed in a namespace, and cannot keep a Runtime or Session alive.

Implementations

impl NativeInstrumentation

pub fn session_id(&self) -> &str

pub fn is_active(&self) -> bool

pub fn register( &self, registration: InstrumentRegistration, ) -> Result<NativeInstrumentHandle, NativeInstrumentationError>

Registers one trusted queued instrument. Transform mode and callback binding are intentionally rejected until their later lifecycle seams are implemented; they never degrade silently to another mode or delivery.

pub fn bind_target( &self, target: &TargetHandle, ) -> Result<NativeTargetHandle, NativeInstrumentationError>

Fences a target identity received from a trusted target-producing host seam. Target implementation objects remain private to Runtime/Session.

pub fn registration( &self, instrument: &NativeInstrumentHandle, ) -> Result<InstrumentRegistration, NativeInstrumentationError>

pub fn target_descriptor( &self, target: &NativeTargetHandle, ) -> Result<TargetDescriptor, NativeInstrumentationError>

pub fn attach( &self, instrument: &NativeInstrumentHandle, target: &NativeTargetHandle, ) -> Result<NativeAttachment, NativeInstrumentationError>

pub fn granted_capabilities( &self, instrument: &NativeInstrumentHandle, target: &NativeTargetHandle, ) -> Result<BTreeSet<Capability>, NativeInstrumentationError>

pub fn queued_event_count( &self, instrument: &NativeInstrumentHandle, ) -> Result<usize, NativeInstrumentationError>

pub fn drain_events( &self, instrument: &NativeInstrumentHandle, ) -> Result<EventBatch, NativeInstrumentationError>

pub fn detach( &self, instrument: &NativeInstrumentHandle, ) -> Result<(), NativeInstrumentationError>

pub fn acquire_control( &self, instrument: &NativeInstrumentHandle, target: &NativeTargetHandle, ) -> Result<NativeControlLease, NativeInstrumentationError>

pub fn release_control( &self, lease: &NativeControlLease, ) -> Result<(), NativeInstrumentationError>

pub fn request_directive( &self, lease: &NativeControlLease, directive: InstrumentDirective, ) -> Result<(), NativeInstrumentationError>

impl NativeInstrumentation

pub fn bind_target_identity( &self, target_id: impl Into<String>, generation: u64, ) -> Result<NativeTargetHandle, NativeInstrumentationError>

Binds one opaque target identity obtained from a trusted Session surface.

The generation is mandatory: a stale identity must not bind a replacement target that later reuses the same id. Resolution still applies the service’s Runtime and Session fences before returning an opaque native target handle.

Trait Implementations

impl Clone for NativeInstrumentation

fn clone(&self) -> NativeInstrumentation

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for NativeInstrumentation

fn fmt(&self, formatter: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.