summaryrefslogtreecommitdiffstats
path: root/third_party/rust/glean/README.md
blob: 4ec6bba9146a0bd467dd6b09b6da1605df6aeda2 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
# Glean

The `Glean SDK` is a modern approach for a Telemetry library and is part of the [Glean project](https://docs.telemetry.mozilla.org/concepts/glean/glean.html).

## `glean`

This library provides a Rust language bindings on top of `glean-core`, targeted to Rust consumers.

## Documentation

All documentation is available online:

* [The Glean SDK Book][book]
* [API documentation][apidocs]

[book]: https://mozilla.github.io/glean/
[apidocs]: https://mozilla.github.io/glean/docs/glean/index.html

## Example

```rust,no_run
use glean::{ConfigurationBuilder, Error, metrics::*};

let cfg = ConfigurationBuilder::new(true, "/tmp/data", "org.mozilla.glean_core.example").build();
glean::initialize(cfg)?;

let prototype_ping = PingType::new("prototype", true, true, vec![]);

glean::register_ping_type(&prototype_ping);

prototype_ping.submit(None);
```

## License

    This Source Code Form is subject to the terms of the Mozilla Public
    License, v. 2.0. If a copy of the MPL was not distributed with this
    file, You can obtain one at http://mozilla.org/MPL/2.0/