9 releases (5 stable)

3.2.0 May 12, 2023
3.1.0 May 12, 2023
2.0.0 Nov 1, 2021
1.0.0 Jul 13, 2020
0.2.3 Nov 29, 2019

#1534 in Web programming

MIT license

40KB
922 lines

ilert-rust   Latest Version ilert: rustc 1.13+

The official ilert API bindings.

In action

use ilert::ilert::ILert;
use ilert::ilert_builders::{UserGetApiResource, EventApiResource, ILertEventType};

let mut client = ILert::new().unwrap();
client.auth_via_token("your-api-token").unwrap();

// create a new alert via event

client
    .create()
    .event(
        "44c7afdc-0b3e-4344-b48a-5378a963231f",
        ILertEventType::ALERT,
        "Host srv/mail01 is CRITICAL", None)
    .execute();

// accept alert

let accept_result = client
    .update()
    .accept_alert(123)
    .execute()
    .unwrap();

// resolve alert

let resolve_result = client
    .update()
    .resolve_alert(123)
    .execute()
    .unwrap();

// fetch users

let user_result = client
    .get()
    .skip(5)
    .limit(10)
    .users()
    .execute()
    .unwrap();

// ping a heartbeat

client
    .get()
    .heartbeat("43c7afdc-0b3e-4344-b48a-5379a963241f")
    .execute();

// create detailed alert via event

client
.create()
.event_with_details(
    "8972f0d5d8c9cde78d79b6cc8fd",
    ILertEventType::ALERT,
    Some("Host srv/mail01 is CRITICAL".to_string()),
    Some("bratwurst".to_string()),
    Some("some detail message".to_string()),
    Some(ILertPriority::LOW),
    Some(vec![EventImage::new("https://i.giphy.com/media/VRhsYYBw8AE36/giphy.webp")]),
    Some(vec![]),
    Some(json!({"hehe": "test"})),
    None)
.execute()
.unwrap();

// add comment to alert via event

client
    .create()
    .event_with_comment(
        "8972f0d5d8c9cde78d79b6cc8fd",
        Some("bratwurst".to_string()),
        Some(vec![EventComment::new("Peter Parker", "a comment ![alt text picture](https://i.giphy.com/media/VRhsYYBw8AE36/giphy.webp)")]))
    .execute()
    .unwrap();

// resolve alert via event

client
    .create()
    .event("8972f0d5d8c9cde78d79b6cc8fd",
        ILertEventType::RESOLVE, None,
        Some("bratwurst".to_string()))
    .execute()
    .unwrap();

Getting help

We are happy to respond to GitHub issues as well.


License

Licensed under either of Apache License, Version 2.0 or MIT license at your option.
Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in ilert-rust by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.

Dependencies

~7–22MB
~324K SLoC