Explanation of terms¶
Terms used in Argus are loosely based on the ITIL standard for IT service management.
incident: an unplanned interruption in the source system.
event: something that happened related to an incident.
acknowledgement: an acknowledgement of an incident by a user, which hides the incident from the other open incidents.
expirationis an instance of
2011-11-11T11:11:11+02:00), the incident will be shown again after the expiration time.
null, the acknowledgement will never expire.
An incident is considered “acked” (acknowledged) if it has one or more acknowledgements that have not expired.
start_time: the time the incident was created.
end_time: the time the incident was resolved or closed.
If the value is an instance of
datetime: the incident is stateful, and was resolved or closed at the given time. If the end time is in the future, the incident is onsidered still open.
null: the incident is stateless (i.e. it cannot be closed).
"infinity": the incident is stateful, but has not yet been resolved or closed - for example, if it is still open.
source: the source system that the incident originated in.
object: the specific object that the incident is about.
parent_object: an object that the
objectis a part of.
problem_type: the type of problem that the incident is about.
tag: a key-value pair in the form of
The key can consist of lowercase letters, numbers and underscores.
The value can consist of any length of any characters.
primary key (abbreviated as
<int:pk>): Argus uses “primary keys” to uniquely identify users, phone numbers, incidents, incident source systems, notification profiles, timeslots and similar. A primary key is a non-negative integer number. It is unique by the context it refers to (for example, phone numbers’
pks are unique for each user).