# Archived Alerts Reporting

IT-Conductor automatically archives all generated alerts and is retained for three years. Customers have the ability to query the archive and export the alerts to CSV files.

### **Query and Export Archived Alerts**

<table><thead><tr><th width="150"> </th><th width="274.35364074450683">URL</th><th>Description</th></tr></thead><tbody><tr><td>Query</td><td>https://service.itconductor.com/objectArchQuery?&#x3C;parameters></td><td>Displays a list of alerts</td></tr><tr><td>Export</td><td>https://service.itconductor.com/objectArchQueryExport?&#x3C;parameters></td><td>Exports selected alerts to comma-separated file</td></tr></tbody></table>

#### Parameters

<table><thead><tr><th width="225">Parameter Name</th><th width="188.20867208672087">Parameter Value</th><th width="150">Required</th><th>Comments</th></tr></thead><tbody><tr><td>OBJECT_ClassName</td><td>Alert</td><td>X</td><td></td></tr><tr><td>OBJECT_CustomerId</td><td>&#x3C;Tenant ID></td><td></td><td>Administrative use only</td></tr><tr><td>ALERT.Time</td><td>[Oper]&#x3C;Time></td><td></td><td>Time has to be specified in your local format/timezone as displayed in the top info-bar</td></tr><tr><td>ALERT.Role</td><td>PROD|QA|DEV|TEST</td><td></td><td>The Role of the system the alert is associated with: Production|Quality Assurance, Development or Test role</td></tr><tr><td>ALERT.ContextPath</td><td>[Oper]&#x3C;value></td><td></td><td>Alert Path</td></tr><tr><td>ALERT.Message</td><td>[Oper]&#x3C;value></td><td></td><td>Alert Message</td></tr><tr><td>ALERT.Severity</td><td>[Oper]&#x3C;value></td><td></td><td>normally the severity values are 6000 for critical and 3000 for warning, specifying value "[GT]3000" will only select Critical alerts</td></tr></tbody></table>

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: '','',... 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)                                                                                                                |

{% hint style="info" %}
**Note:** No characters such as ?,&, =, or # are allowed in the parameter values as these are used as URL delimiters.
{% endhint %}

### Authorizations

Export authorization is required to perform archive queries. This authorization is granted to the Tenant Administrators' role.

Sample URL:

```
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
```