Skip to main content

Problem Candidates API

The Problem Candidates API provides read-only access to potential incidents or anomalies detected by Lumetry's evaluation engine that have not yet been promoted to full incidents.

List Problem Candidates​

GET /api/problem-candidates

Returns a list of problem candidates, ordered by the most recently seen.

Query Parameters:

  • status (String, Optional): Filter by status (e.g., Open or Dismissed).
  • type (String, Optional): Filter by the candidate type.
  • limit (Integer, Optional): Maximum number of results to return. Defaults to 500, maximum 1000.

Response Properties:

  • id (Integer): The unique ID of the candidate.
  • candidateKey (String): A stable deduplication key for this candidate.
  • candidateType (String): The type or category of the candidate.
  • severity (String): The severity level of the problem.
  • title (String): A short title describing the problem.
  • summary (String): A detailed summary.
  • relatedServiceNodeId (Integer, Optional): The topology node ID of the affected service.
  • relatedCiNodeId (Integer, Optional): The topology node ID of the affected Configuration Item (CI).
  • relatedMetricId (String, Optional): The ID of the metric that triggered the candidate.
  • rootCauseNodeId (Integer, Optional): The topology node ID identified as the root cause.
  • firstSeenAt (DateTime): When the candidate was first detected.
  • lastSeenAt (DateTime): When the candidate was most recently updated.
  • occurrenceCount (Integer): How many times this candidate's trigger conditions were observed.
  • status (String): The current status (Open or Dismissed).