Skip to content

Commit f2bf424

Browse files
Merge branch 'master' into lens/field-list-error-handling
2 parents 09e82da + 8a21d11 commit f2bf424

41 files changed

Lines changed: 1865 additions & 252 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

docs/user/alerting/action-types.asciidoc

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -23,6 +23,10 @@ a| <<server-log-action-type, ServerLog>>
2323

2424
| Add a message to a Kibana log.
2525

26+
a| <<servicenow-action-type, ServiceNow>>
27+
28+
| Push or update data to a new incident in ServiceNow.
29+
2630
a| <<slack-action-type, Slack>>
2731

2832
| Send a message to a Slack channel or user.
@@ -55,3 +59,4 @@ include::action-types/server-log.asciidoc[]
5559
include::action-types/slack.asciidoc[]
5660
include::action-types/webhook.asciidoc[]
5761
include::action-types/pre-configured-connectors.asciidoc[]
62+
include::action-types/servicenow.asciidoc[]
Lines changed: 72 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,72 @@
1+
[role="xpack"]
2+
[[servicenow-action-type]]
3+
=== ServiceNow action
4+
5+
The ServiceNow action type uses the https://developer.servicenow.com/app.do#!/rest_api_doc?v=orlando&id=c_TableAPI[V2 Table API] to create ServiceNow incidents.
6+
7+
[float]
8+
[[servicenow-connector-configuration]]
9+
==== Connector configuration
10+
11+
ServiceNow connectors have the following configuration properties:
12+
13+
Name:: The name of the connector. The name is used to identify a connector in the management UI connector listing, or in the connector list when configuring an action.
14+
URL:: ServiceNow instance URL.
15+
Username:: Username for HTTP Basic authentication.
16+
Password:: Password for HTTP Basic authentication.
17+
18+
[float]
19+
[[Preconfigured-servicenow-configuration]]
20+
==== Preconfigured action type
21+
22+
[source,text]
23+
--
24+
my-servicenow:
25+
name: preconfigured-servicenow-action-type
26+
actionTypeId: .servicenow
27+
config:
28+
apiUrl: https://dev94428.service-now.com/
29+
secrets:
30+
username: testuser
31+
password: passwordkeystorevalue
32+
--
33+
34+
`config` defines the action type specific to the configuration and contains the following properties:
35+
36+
[cols="2*<"]
37+
|===
38+
39+
| `apiUrl`
40+
| An address that corresponds to *Sender*.
41+
42+
|===
43+
44+
`secrets` defines sensitive information for the action type:
45+
46+
[cols="2*<"]
47+
|===
48+
49+
| `username`
50+
| A string that corresponds to *User*.
51+
52+
| `password`
53+
| A string that corresponds to *Password*. Should be stored in the <<creating-keystore, {kib} keystore>>.
54+
55+
|===
56+
57+
[[servicenow-action-configuration]]
58+
==== Action configuration
59+
60+
ServiceNow actions have the following configuration properties:
61+
62+
Urgency:: The extent to which the incident resolution can delay.
63+
Severity:: The severity of the incident.
64+
Impact:: The effect an incident has on business. Can be measured by the number of affected users or by how critical it is to the business in question.
65+
Short description:: A short description of the incident, used for searching the contents of the knowledge base.
66+
Description:: The details about the incident.
67+
Additional comments:: Additional information for the client, such as how to troubleshoot the issue.
68+
69+
[[configuring-servicenow]]
70+
==== Configuring and testing ServiceNow
71+
72+
ServiceNow offers free https://developer.servicenow.com/dev.do#!/guides/madrid/now-platform/pdi-guide/obtaining-a-pdi[Personal Developer Instances], which you can use to test incidents.
-554 KB
Binary file not shown.
403 KB
Loading
-341 KB
Binary file not shown.
272 KB
Loading
-98.8 KB
Binary file not shown.
98.6 KB
Loading
-485 KB
Binary file not shown.
409 KB
Loading

0 commit comments

Comments
 (0)