Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/axiomhq/tracing-axiom
The official Rust tracing layer for Axiom
https://github.com/axiomhq/tracing-axiom
axiom opentelemetry telemetry tracing
Last synced: 3 months ago
JSON representation
The official Rust tracing layer for Axiom
- Host: GitHub
- URL: https://github.com/axiomhq/tracing-axiom
- Owner: axiomhq
- License: apache-2.0
- Created: 2022-08-26T07:31:46.000Z (about 2 years ago)
- Default Branch: main
- Last Pushed: 2024-05-22T15:11:35.000Z (6 months ago)
- Last Synced: 2024-05-22T16:12:17.474Z (6 months ago)
- Topics: axiom, opentelemetry, telemetry, tracing
- Language: Rust
- Homepage: https://axiom.co
- Size: 137 KB
- Stars: 17
- Watchers: 4
- Forks: 4
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- License: LICENSE-APACHE
Awesome Lists containing this project
README
[](https://docs.rs/tracing-axiom/)
[](https://github.com/axiomhq/tracing-axiom/actions?query=workflow%3ACI)
[](https://crates.io/crates/tracing-axiom)
[](LICENSE-APACHE)
[Axiom](https://axiom.co) unlocks observability at any scale.
- **Ingest with ease, store without limits:** Axiom’s next-generation datastore enables ingesting petabytes of data with ultimate efficiency. Ship logs from Kubernetes, AWS, Azure, Google Cloud, DigitalOcean, Nomad, and others.
- **Query everything, all the time:** Whether DevOps, SecOps, or EverythingOps, query all your data no matter its age. No provisioning, no moving data from cold/archive to “hot”, and no worrying about slow queries. All your data, all. the. time.
- **Powerful dashboards, for continuous observability:** Build dashboards to collect related queries and present information that’s quick and easy to digest for you and your team. Dashboards can be kept private or shared with others, and are the perfect way to bring together data from different sources
For more information check out the [official documentation](https://axiom.co/docs).
## Usage
Add the following to your `Cargo.toml`:
```toml
[dependencies]
tracing-axiom = "0.7"
```
Create a dataset in Axiom and export the name as `AXIOM_DATASET`.
Then create an API token with ingest permission into that dataset in
[the Axiom settings](https://cloud.axiom.co/settings/profile) and export it as
`AXIOM_TOKEN`.
Now you can set up tracing like this:
```rust,no_run
use tracing_subscriber::{layer::SubscriberExt as _, util::SubscriberInitExt as _, Registry};
#[tokio::main]
async fn main() -> Result<(), Box> {
let axiom_layer = tracing_axiom::default("readme")?; // Set AXIOM_DATASET and AXIOM_TOKEN in your env!
Registry::default().with(axiom_layer).init();
say_hello();
Ok(())
}
#[tracing::instrument]
pub fn say_hello() {
tracing::info!("Hello, world!");
}
```
For further examples, head over to the [examples](examples) directory.
> **Note**: Due to a limitation of an underlying library, [events outside of a
> span are not recorded](https://docs.rs/tracing-opentelemetry/latest/src/tracing_opentelemetry/layer.rs.html#807).
## Features
The following are a list of
[Cargo features](https://doc.rust-lang.org/stable/cargo/reference/features.html#the-features-section)
that can be enabled or disabled:
- **rustls-tls** _(enabled by default)_: Enables TLS functionality provided by `rustls`.
- **default-tls**: uses reqwest default TLS library.
- **native-tls**: Enables TLS functionality provided by `native-tls`.
## FAQ & Troubleshooting
### How do I log traces to the console in addition to Axiom?
You can use this library to get a [`tracing-subscriber::layer`](https://docs.rs/tracing-subscriber/latest/tracing_subscriber/layer/index.html)
and combine it with other layers, for example one that prints traces to the
console.
You can see how this works in the [fmt example](./examples/fmt).
### My test function hangs indefinitely
This can happen when you use `#[tokio::test]` as that defaults to a
single-threaded executor, but the
[`opentelemetry`](https://docs.rs/opentelemetry) crate requires a multi-thread
executor.
## License
Licensed under either of
- Apache License, Version 2.0, ([LICENSE-APACHE](LICENSE-APACHE) or [apache.org/licenses/LICENSE-2.0](http://www.apache.org/licenses/LICENSE-2.0))
- MIT license ([LICENSE-MIT](LICENSE-MIT) or [opensource.org/licenses/MIT](http://opensource.org/licenses/MIT))
at your option.