ddquery-core 0.2.0

A pure-Rust parser and explainer for Datadog monitor queries: tokenize a raw monitor query into a typed, serializable AST, then render it to JSON or a plain-language summary.
Documentation 
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

//! Parse a Datadog monitor query and print its AST, structured summary, and
//! plain-language explanation.
//!
//! ```bash
//! cargo run -p ddquery-core --example explain -- 'avg(last_5m):avg:system.cpu.user{env:prod} > 90'
//! ```
//!
//! With no argument, a built-in sample query is used.

use std::env;

use ddquery_core::{explain, parse_or_unparsed, summarize};

fn main() {
    let query = env::args().nth(1).unwrap_or_else(|| {
        "avg(last_1d):anomalies(sum:app.service.latency{platform:macos, country:us}.as_count(), \
         'agile', 5, direction='below', seasonality='daily') >= 1"
            .to_string()
    });

    let ast = parse_or_unparsed(&query);

    println!("query:\n  {query}\n");
    println!("explanation:\n  {}\n", explain(&ast));

    let summary = summarize(&ast, &query);
    match serde_json::to_string_pretty(&summary) {
        Ok(json) => println!("summary:\n{json}\n"),
        Err(e) => eprintln!("failed to serialize summary: {e}"),
    }

    match serde_json::to_string_pretty(&ast) {
        Ok(json) => println!("ast:\n{json}"),
        Err(e) => eprintln!("failed to serialize AST: {e}"),
    }
}