Struct appinsights::telemetry::RemoteDependencyTelemetry

pub struct RemoteDependencyTelemetry { /* private fields */ }

Represents interactions of the monitored component with a remote component/service like SQL or an HTTP endpoint.

Examples

use appinsights::telemetry::{Telemetry, RemoteDependencyTelemetry};
use std::time::Duration;

// create a telemetry item
let mut telemetry = RemoteDependencyTelemetry::new(
    "GET https://api.github.com/dmolokanov/appinsights-rs",
    "HTTP",
    Duration::from_secs(2),
    "api.github.com",
    true,
);

// attach custom properties, measurements and context tags
telemetry.properties_mut().insert("component".to_string(), "data_processor".to_string());
telemetry.tags_mut().insert("os_version".to_string(), "linux x86_64".to_string());
telemetry.measurements_mut().insert("body_size".to_string(), 115.0);

// submit telemetry item to server
client.track(telemetry);

Implementations

impl RemoteDependencyTelemetry

pub fn new(
    name: impl Into<String>,
    dependency_type: impl Into<String>,
    duration: StdDuration,
    target: impl Into<String>,
    success: bool
) -> Self

Creates a new telemetry item with specified name, dependency type, target site and success status.

pub fn measurements(&self) -> &Measurements

Returns custom measurements to submit with the telemetry item.

pub fn measurements_mut(&mut self) -> &mut Measurements

Returns mutable reference to custom measurements.

pub fn set_id(&mut self, id: impl Into<String>)

Sets the dependency id. Use this to link other telemetry to this dependency by setting their operation parent id to this id.

let operation_id = "...".to_string();
let dependency_id = "...".to_string();

let mut dependency = RemoteDependencyTelemetry::new(
    "Data processing",
    "InProc",
    Duration::from_millis(42),
    "internal",
    true,
);
dependency.set_id(dependency_id.clone());
dependency.tags_mut().operation_mut().set_id(operation_id.clone());
client.track(dependency);

let mut trace = TraceTelemetry::new("Start", SeverityLevel::Information);
trace.tags_mut().operation_mut().set_id(operation_id);
trace.tags_mut().operation_mut().set_parent_id(dependency_id);
client.track(trace);

Trait Implementations

impl Debug for RemoteDependencyTelemetry

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

Formats the value using the given formatter.

impl Telemetry for RemoteDependencyTelemetry

fn timestamp(&self) -> DateTime<Utc>

Returns the time when this telemetry was measured.

fn properties(&self) -> &Properties

Returns custom properties to submit with the telemetry item.

fn properties_mut(&mut self) -> &mut Properties

Returns mutable reference to custom properties.

fn tags(&self) -> &ContextTags

Returns context data containing extra, optional tags. Overrides values found on client telemetry context.

fn tags_mut(&mut self) -> &mut ContextTags

Returns mutable reference to custom tags.