Skip to main content
sdmx-dl
GitHub Toggle Dark/Light/Auto mode Toggle Dark/Light/Auto mode Toggle Dark/Light/Auto mode Back to homepage

Monitor and status

Check whether a source is up, and how it has been performing, before relying on it in an automated job.

//JAVA 25+
//DEPS com.github.nbbrd.sdmx-dl:sdmx-dl-standalone:3.2.0
import sdmxdl.web.SdmxWebManager;

void main() throws Exception {
    SdmxWebManager manager = SdmxWebManager.ofServiceLoader();
    IO.println(manager.getMonitorReport("ECB"));
}
sdmx-dl check status ECB

check status also accepts several sources at once, or the keyword all to check every configured source in parallel:

sdmx-dl check status ECB IMF INSEE
sdmx-dl check status all

REST

curl "localhost:4559/sdmx-dl/v2/statuses?sources=ECB"

ListStatuses also accepts several comma-separated sources, or all to check every configured source:

curl "localhost:4559/sdmx-dl/v2/statuses?sources=ECB,IMF,INSEE"
curl "localhost:4559/sdmx-dl/v2/statuses?sources=all"

gRPC

grpcurl -d '{"sources":["ECB"]}' -plaintext localhost:4557 sdmxdl.grpc.v2.SdmxWebManager.ListStatuses

Notes

  • A report includes a status (UP/DOWN/UNKNOWN), an uptime ratio, and an average response time; the CLI table adds an error message column when a check fails.
  • Only sources that declare a monitor endpoint in their configuration can be checked; others report “No monitor defined”.
  • WS’s ListStatuses mirrors the CLI’s ability to batch-check several sources (or all) in a single call, instead of one request per source.