Attributes
Timestamp when the alert evaluation began (Unix timestamp)
Time bucket identifier for the alert evaluation period
The actual metric value that triggered the alert
Time bucket identifier for baseline comparison (if applicable)
The baseline metric value used for comparison (if applicable)
Boolean indicating if this record represents an active alert
Warning threshold value at the time of evaluation
Critical threshold value at the time of evaluation
Alert severity level (“CRITICAL”, “WARNING”, “INFO”)
Reason for alert evaluation failure (if applicable)
Human-readable alert message with context
Name of the specific feature that triggered the alert (if applicable)
Major version of the alert record format
Minor version of the alert record format
Unique identifier for this alert record
Revision number of the alert rule at trigger time
Timestamp when the alert record was created
Timestamp when the alert record was last modified
Example
Alert records are read-only entities created automatically by the Fiddler
platform when AlertRules trigger. They cannot be created or modified directly
but provide valuable historical data for analysis and debugging.
Alert records are read-only entities that capture historical alert
trigger events. They are created automatically by the system and
cannot be modified after creation.
classmethod list()
List alert records triggered by a specific alert rule. Retrieves historical alert records for analysis and troubleshooting. This method provides access to all alert trigger events within a specified time range, enabling pattern analysis and threshold tuning.Parameters
UUID | str
required
The unique identifier of the AlertRule to retrieve records for.
Must be a valid alert rule UUID.
datetime | None
default:"7 days ago"
Start time for filtering alert records. If None, defaults to
7 days ago. Used to define the beginning of the query window.
datetime | None
default:"current time"
End time for filtering alert records. If None, defaults to
current time. Used to define the end of the query window.
list[str] | None
default:"None"
List of field names for result ordering. Prefix with ”-” for
descending order (e.g., [“-created_at”] for newest first).
Yields
AlertRecord – Alert record instances with complete
trigger details and context information.
Returns
Iterator[AlertRecord]
Example
Results are paginated automatically. The default time range is 7 days
to balance performance with useful historical context. Use ordering
parameters to get the most relevant results first.