Lue luvut Prometheukseen

Teams-paketista alkaen

Teams-paketista alkaen https://www.mailmoni.com/metrics antaa Prometheukselle organisaatiosi luvut Prometheuksen omassa tekstimuodossa: viestit lähteittäin ja DMARC-tuloksittain, viimeisimmän raportin saapumisajan, kunkin DNS-tarkistuksen tuloksen ja avointen hälytysten määrän. Prometheus lukee päätepistettä API-avaimella.

Ota keruu käyttöön

Ylläpitäjä luo avaimen kohdassa Asetukset → Kehittäjille → API-avaimet, kuten sivu API-avaimet kertoo. Lisää tämä job-määritys tiedostoon prometheus.yml ja korvaa YOUR_TOKEN avaimella:

scrape_configs:
  - job_name: mailmoni
    scheme: https
    metrics_path: /metrics
    scrape_interval: 60s
    authorization:
      credentials: YOUR_TOKEN
    static_configs:
      - targets: ["www.mailmoni.com"]

Prometheus lähettää avaimen Authorization-otsakkeessa. Sivu, joka näyttää uuden avaimen, näyttää tämän määrityksen valmiiksi avaimen kanssa.

Kuinka usein luvut kerätään

Päätepisteellä /metrics on oma laskurinsa kullekin avaimelle ja tunnille, erillään API:n laskurista:

Paketti	Keruita tunnissa avainta kohden
Starter	0
Pro	0
Teams	360
Enterprise	1 800

Keruu saa luvut, jotka ovat enintään 5 minuuttia vanhoja, joten keruu kerran minuutissa riittää. Rajan ylittävä keruu saa vastauksen rate_limited ja Retry-After-otsakkeen.

Sarjat

Sarja	Mitä se laskee	Nimiöt
`mailmoni_messages`	Messages reported for the domain, by source and DMARC result, over the last complete UTC day (1d) or the last seven (7d).	`domain` `source` `result` `window`
`mailmoni_last_report_timestamp_seconds`	When the newest report of this kind for the domain was stored, as a Unix timestamp.	`domain` `kind`
`mailmoni_dns_check_ok`	1 when the latest DNS check of this record found nothing worse than information, else 0.	`domain` `check`
`mailmoni_dns_last_check_timestamp_seconds`	When the domain's DNS records were last checked, as a Unix timestamp.	`domain`
`mailmoni_open_alerts`	Open alerts for the domain, by severity.	`domain` `severity`

Kuvaukset ovat englanniksi, kuten Prometheus ne näyttää. Nimet ja nimiöt pysyvät samoina, joten niiden varaan tehdyt kojelaudat ja hälytyssäännöt toimivat jatkossakin.

Nimiöt

domain: organisaation jokainen vahvistettu pääverkkotunnus. Aliverkkotunnuksen posti lasketaan pääverkkotunnuksen sarjaan mailmoni_messages, joten sum() laskee sen vain kerran. DNS-sarjoissa näkyy lisäksi jokainen aliverkkotunnus.
source: lähettävän palvelun nimi, unidentified postille, jota emme pystyneet yhdistämään palveluun, ja other kaikelle, mikä jää verkkotunnuksen 25 suurimman lähteen ulkopuolelle 7d-ikkunan määrillä mitattuna.
result: DMARC-tulos pass tai fail.
window: 1d on viimeisin kokonainen UTC-päivä ja 7d viimeiset seitsemän. Molemmat päättyvät eiliseen, joten tämän päivän raportit näkyvät huomenna.
kind: raportin laji, aggregate tai tls.
check: DNS-tietue, jonka tarkistus luki, esimerkiksi dmarc tai spf.
severity: avointen hälytysten vakavuus.

Esimerkkikyselyjä

Kunkin verkkotunnuksen postista se osuus, joka läpäisi DMARC-tarkistuksen 7d-ikkunassa:

sum by (domain) (mailmoni_messages{result="pass", window="7d"})
  / sum by (domain) (mailmoni_messages{window="7d"})

DNS-tarkistukset, jotka löysivät varoituksen tai ongelman eli jotain huomiota vakavampaa:

mailmoni_dns_check_ok == 0

Verkkotunnukset, joille ei ole tallennettu koontiraporttia kahteen päivään:

time() - mailmoni_last_report_timestamp_seconds{kind="aggregate"} > 2 * 86400

Verkkotunnuksella, jolle ei ole koskaan tallennettu koontiraporttia, ei ole tätä sarjaa, joten kysely ei näytä sitä. absent() löytää puuttuvan sarjan:

absent(mailmoni_last_report_timestamp_seconds{domain="example.com", kind="aggregate"})

Kun paketti vaihtuu

Teams-pakettia alemmissa paketeissa /metrics antaa vastauksen plan tilalla 403. Avaimet säilyvät, ja keruu toimii taas, kun organisaatiolla on jälleen Teams-paketti tai sitä parempi.

Julkaistu 27. lokakuuta 2026 · Tarkistettu 27. lokakuuta 2026