monocle 1.4.0

A commandline application to search, parse, and process BGP information in public sources.
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
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96

//! `POST /api/v1/inspect/query` — unified AS/prefix/country lookup.

use std::collections::HashSet;

use axum::extract::State;
use axum::Json;
use serde::Deserialize;

use crate::lens::inspect::{InspectDataSection, InspectLens, InspectQueryOptions, InspectResult};
use crate::server::http::{ApiError, ApiErrorCode, ApiErrorResponse};
use crate::server::ServerState;

#[derive(Debug, Clone, Deserialize)]
pub struct InspectQueryRequest {
    /// One or more queries (ASN, prefix, or AS name).
    #[serde(default)]
    pub queries: Vec<String>,
    /// Data sections to include. None = defaults based on query type.
    #[serde(default)]
    pub select: Option<Vec<String>>,
    /// Maximum ROAs to return (0 = unlimited).
    #[serde(default)]
    pub max_roas: Option<usize>,
    /// Maximum prefixes to return (0 = unlimited).
    #[serde(default)]
    pub max_prefixes: Option<usize>,
    /// Maximum neighbors per category (0 = unlimited).
    #[serde(default)]
    pub max_neighbors: Option<usize>,
}

pub async fn inspect_query(
    State(state): State<ServerState>,
    Json(req): Json<InspectQueryRequest>,
) -> Result<Json<InspectResult>, ApiError> {
    if req.queries.is_empty() {
        return Err(ApiError::invalid_params("At least one query is required"));
    }

    let data_dir = state.config.data_dir.clone();
    let config = state.config.as_ref().clone();

    let select = req.select.map(|s| {
        s.into_iter()
            .filter_map(|name| match name.as_str() {
                "basic" => Some(InspectDataSection::Basic),
                "prefixes" => Some(InspectDataSection::Prefixes),
                "connectivity" => Some(InspectDataSection::Connectivity),
                "rpki" => Some(InspectDataSection::Rpki),
                _ => None,
            })
            .collect::<HashSet<_>>()
    });

    let options = InspectQueryOptions {
        select,
        max_roas: req.max_roas.unwrap_or(0),
        max_prefixes: req.max_prefixes.unwrap_or(0),
        max_neighbors: req.max_neighbors.unwrap_or(0),
        max_search_results: 0,
    };

    let queries = req.queries.clone();

    let result = tokio::task::spawn_blocking(move || -> anyhow::Result<InspectResult> {
        let db = crate::database::MonocleDatabase::open_in_dir(&data_dir)?;
        let lens = InspectLens::new(&db, &config);

        if !lens.is_data_available() {
            anyhow::bail!("NOT_INITIALIZED:INSPECT");
        }

        let result = lens.query(&queries, &options)?;
        Ok(result)
    })
    .await
    .map_err(|e| ApiError::internal(format!("Task join error: {}", e)))?;

    match result {
        Ok(r) => Ok(Json(r)),
        Err(e) => {
            let msg = e.to_string();
            if msg.contains("NOT_INITIALIZED") {
                Err(ApiError::new(
                    axum::http::StatusCode::SERVICE_UNAVAILABLE,
                    ApiErrorResponse::new(
                        ApiErrorCode::NotInitialized,
                        "Inspect data not initialized. Run inspect/refresh first.",
                    ),
                ))
            } else {
                Err(ApiError::internal(msg))
            }
        }
    }
}