IT-Conductor automatically archives all generated alerts. They are retained for 3 years. Customers have the ability to query the archive and export the alerts to CSV files.
Instructions
Query and Export archived alerts
| URL | Description | ||
|---|---|---|---|
| Query | https://service.itconductor.com/objectArchQuery?<parameters> | Displays a list of alerts | |
| Export | https://service.itconductor.com/objectArchQueryExport?<parameters> | Exports selected alerts to comma-separated file |
Parameters
| Parameter Name | Parameter Value | Required | Comments |
|---|---|---|---|
| OBJECT_ClassName | Alert | X | |
| OBJECT_CustomerId | <Tenant ID> | Administrative use Only | |
| ALERT.Time | [Oper]<Time> | Time has to be specified in your local format/timezone as displayed in the top info-bar | |
| ALERT.Role | PROD|QA|DEV|TEST | The Role of the system the alert is associated with: Production|Quality Assurance, Development or Test role | |
| ALERT.ContextPath | [Oper]<value> | Alert Path | |
| ALERT.Message | [Oper]<value> | Alert Message | |
| ALERT.Severity | [Oper]<value> | normally the severity values are 6000 for critical and 3000 for warning, specifying value "[GT]3000" will only select Critical alerts |
Where
| [Oper] | an optional logical comparison operator (default is EQ), has to be surrounded by square brackets [], allowed values are: |
| GT,GE,LT,LE,NE | >,>=,<,<=,!= - applied to strings, numbers and time |
| IN | equals to one of the value in the list: '<value1>','<value2>',... the values have to be surrounded by single quotes '. No escaping of ' is supported |
| NOT_IN | not IN (see above) |
| MATCH | matches RegEx (Regular Expression) |
| NOT_MATCH | not MATCH (see above) |
! No characters such as ?,&, = or # are allowed in the parameter values as these are used as URL delimiters.
Authorizations
Export authorization is required to perform archive query - this authorization is granted to Tenant Administrators role.
Example
https://service.itconductor.com/objectArchQuery?OBJECT_ClassName=Alert&OBJECT_CustomerId=123456&ALERT.Time=[GT]01/29/2018 00:00:00 AM&ALERT.ContextPath=[MATCH]/PRD&ALERT.Message=[MATCH]Response Time
Related articles
0 Comments