Application Insights for Rust

This project provides a Rust SDK for Application Insights. Application Insights is an APM service that helps to monitor running applications. This Rust crate allows to send various kinds of telemetry information to the server to be visualized later on Azure Portal.

:triangularflagon_post: Disclaimer
This project is not an officially recognized Microsoft product and is not an endorsement of any future product offering from Microsoft.

Microsoft and Azure are registered trademarks of Microsoft Corporation.

Installation

bash $ cargo add appinsights or just add this to your Cargo.toml:

toml [dependencies] appinisghts = "0.2"

Usage

To start tracking telemetry for your application first thing you need to do is to obtain an Instrumentation Key and initialize TelemetryClient with it.

This client will be used to send all telemetry data to Application Insights. This SDK doesn't collect any telemetry automatically, so this client should be used everywhere in the code to report health information about an application.

```rust use appinsights::TelemetryClient;

[tokio::main]

async fn main() { // configure telemetry client with default settings let client = TelemetryClient::new("".to_string());

// send event telemetry to the Application Insights server
client.track_event("application started");

// stop the client
client.close_channel().await;

} `` If you need more control over the client's behavior, you can create a new instance ofTelemetryConfigand initialize aTelemetryClient` with it.

```rust use std::time::Duration; use appinsights::{TelemetryClient, TelemetryConfig}; use appinsights::telemetry::SeverityLevel;

[tokio::main]

async fn main() { // configure telemetry config with custom settings let config = TelemetryConfig::builder() // provide an instrumentation key for a client .ikey("") // set a new maximum time to wait until data will be sent to the server .interval(Duration::fromsecs(5)) // construct a new instance of telemetry configuration .build();

// configure telemetry client with default settings
let client = TelemetryClient::from_config(config);

// send trace telemetry to the Application Insights server
client.track_trace("A database error occurred", SeverityLevel::Warning);

// stop the client
client.close_channel().await;

} ```

License

This project is licensed under the terms of the MIT license.