Raise a ticket from an event
Raise a ticket to hand an event to the service desk. One click creates an incident in the client’s own ServiceNow instance, with the event details filled in.
You need:
- The admin or member role. Viewers see Raise Ticket greyed out.
- A plan that includes the ITSM connector (the Super plan).
- ServiceNow connected for the workspace, with Enable ticketing switched on. An admin does this once. See ServiceNow ticketing and Connect ServiceNow.
If any of these is missing for the workspace, there is no Raise Ticket button at all.
Raise the ticket
Section titled “Raise the ticket”- Open Dashboard and scroll to Real-time events.
- Find the event. Use Search event types… or the tenant drop-down.
- Choose Raise Ticket on the row. Or choose View, then Raise Ticket in Event Details.
- Wait while the button reads Raising…. There is no form and no confirmation.
- Write down the number in the message ServiceNow incident {INC number} created. Identiguard does not keep it on the event.
- Open ServiceNow and find the incident by that number.
- If the event is now dealt with, dismiss it separately. Raising a ticket does not dismiss the event. See Dismiss events.
When it worked: you see ServiceNow incident {INC number} created. and the incident exists in ServiceNow.
What the ServiceNow incident contains
Section titled “What the ServiceNow incident contains”Identiguard builds the incident from the stored event. Nothing that you type is sent.
| ServiceNow field | Contents |
|---|---|
| Short description | Identiguard: followed by the event message, or by the event type when there is no message |
| Description | One line each for Tenant Name, Raised by (your email address), Tenant ID, Event ID, Source, Severity, Event Time and Identiguard Event Link |
| Urgency and impact | Set from the event’s severity. See the table below. |
| Correlation ID | identiguard:{workspace ID}:{event ID}. The service desk can use it to recognise the same event twice. |
| Assignment group and caller | Set only when an admin entered them on the ITSM page |
The Identiguard Event Link opens the workspace’s full-page event feed. It does not open one event. Use the Event ID in the description to identify the event.
| Severity | Urgency | Impact |
|---|---|---|
CRITICAL |
1 | 1 |
ERROR |
2 | 2 |
WARN |
3 | 2 |
INFO |
3 | 3 |
DEBUG |
3 | 3 |
A severity that Identiguard does not recognise is sent as urgency 3 and impact 3. Urgency and impact come from the event’s severity, not from an event priority score.
HubSpot, for Innovate IT internal workspaces
Section titled “HubSpot, for Innovate IT internal workspaces”In Innovate IT’s own internal workspaces, a platform operator can switch on HubSpot ticketing. Raise Ticket then creates a HubSpot ticket, and the message reads HubSpot ticket {id} created. A connected ServiceNow instance always takes priority over HubSpot. Client workspaces use ServiceNow only.
If it does not work
Section titled “If it does not work”The button
Section titled “The button”| What you see | Why | What to do |
|---|---|---|
| No Raise Ticket button | The plan does not include ITSM, or ServiceNow is not connected, or Enable ticketing is off | An admin connects ServiceNow under ITSM and switches on Enable ticketing. See Connect ServiceNow. |
| Raise Ticket is greyed out | You are a viewer | Ask an admin for the member role |
| Ticketing is disabled or not available for your role. | You are not allowed to raise tickets, or there is no ticketing connection | As for the two rows above |
| The button stays on Raising… | The request is still in progress | Wait. Do not reload and click again, or you may create two incidents. |
Messages after you click
Section titled “Messages after you click”| What you see | Why | What to do |
|---|---|---|
| The ITSM connector is not available on this workspace plan. | The plan does not include ITSM | Upgrade the plan, or ask the billing owner. See Manage billing. |
| ServiceNow is not configured for this workspace. | No ServiceNow connection is saved | An admin sets it up under ITSM |
| The ServiceNow connector is turned off for this workspace. | Enable ticketing is off | An admin switches it on under ITSM |
| Event not found in this workspace. | The event passed its retention period, or was removed | Raise the ticket by hand in ServiceNow |
| The event could not be loaded to raise a ticket for it. | Identiguard could not read the stored event | Try again |
| eventId is required. | The row has no event ID | Report it to the product team |
| ServiceNow authentication failed ({status}): {reason} | The OAuth client ID or secret is wrong or expired, or the client credentials grant is not enabled in ServiceNow | An admin corrects the credentials under ITSM, then uses Send test incident |
| ServiceNow did not return an access token. | The instance answered without a token | Check the OAuth application registration in ServiceNow |
| ServiceNow assignment group lookup failed ({status}). | Identiguard could not look up the assignment group | Check the rights of the OAuth Application User in ServiceNow |
| ServiceNow assignment group “{name}” was not found on the instance. | The Assignment group name is wrong | An admin corrects it under ITSM |
| ServiceNow incident creation failed ({status}). | ServiceNow rejected the incident. Common causes are missing rights or a mandatory field. | Check that the OAuth Application User has the itil role and that no extra field is mandatory. Use Send test incident under ITSM. |
| Failed to raise ServiceNow ticket. | A network or unexpected error | Try again |
| Too many requests. Try again in 60 seconds. | You reached the request limit for one user | Wait 60 seconds |
HubSpot messages (internal workspaces only)
Section titled “HubSpot messages (internal workspaces only)”| What you see | Why | What to do |
|---|---|---|
| HubSpot ticketing is disabled for this workspace. | HubSpot ticketing is not switched on | Contact a platform operator |
| HubSpot is not configured. Missing private app token. | The HubSpot connection is not set up | Contact a platform operator |
| A message that begins HubSpot ticketing is enabled but not fully configured. or HubSpot ticketing configuration is invalid. | The HubSpot pipeline or stage is not set, or is wrong | Contact a platform operator |
| HubSpot ticket creation failed ({status}). | HubSpot rejected the ticket | Contact a platform operator |
For setup problems, see ServiceNow ticketing.