Skip to content

Commit e14f9bb

Browse files
Merge branch 'main' into RAM-142183-create-bulk-delete-on-rules-front
2 parents 825492e + e580f23 commit e14f9bb

File tree

116 files changed

+4849
-430
lines changed

Some content is hidden

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

116 files changed

+4849
-430
lines changed

.github/CODEOWNERS

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -47,6 +47,8 @@
4747
/x-pack/test/functional/apps/lens @elastic/kibana-visualizations
4848
/x-pack/test/api_integration/apis/lens/ @elastic/kibana-visualizations
4949
/test/functional/apps/visualize/ @elastic/kibana-visualizations
50+
/src/plugins/expressions/ @elastic/kibana-visualizations
51+
/src/plugins/unified_search/ @elastic/kibana-visualizations
5052

5153
# Application Services
5254
/examples/dashboard_embeddable_examples/ @elastic/kibana-app-services
@@ -57,10 +59,9 @@
5759
/examples/field_formats_example/ @elastic/kibana-app-services
5860
/examples/partial_results_example/ @elastic/kibana-app-services
5961
/examples/search_examples/ @elastic/kibana-app-services
60-
/src/plugins/data/ @elastic/kibana-app-services
62+
/src/plugins/data/ @elastic/kibana-visualizations @elastic/kibana-data-discovery
6163
/src/plugins/data_views/ @elastic/kibana-app-services
6264
/src/plugins/embeddable/ @elastic/kibana-app-services
63-
/src/plugins/expressions/ @elastic/kibana-app-services
6465
/src/plugins/field_formats/ @elastic/kibana-app-services
6566
/src/plugins/data_view_editor/ @elastic/kibana-app-services
6667
/src/plugins/inspector/ @elastic/kibana-app-services
@@ -69,7 +70,6 @@
6970
/src/plugins/data_view_field_editor @elastic/kibana-app-services
7071
/src/plugins/data_view_management/ @elastic/kibana-app-services
7172
/src/plugins/inspector/ @elastic/kibana-app-services
72-
/src/plugins/unified_search/ @elastic/kibana-app-services
7373
/x-pack/plugins/embeddable_enhanced/ @elastic/kibana-app-services
7474
/x-pack/plugins/runtime_fields @elastic/kibana-app-services
7575
/src/plugins/dashboard/public/application/embeddable/viewport/print_media @elastic/kibana-app-services
@@ -937,7 +937,7 @@ packages/kbn-health-gateway-server @elastic/kibana-core
937937
packages/kbn-i18n @elastic/kibana-core
938938
packages/kbn-i18n-react @elastic/kibana-core
939939
packages/kbn-import-resolver @elastic/kibana-operations
940-
packages/kbn-interpreter @elastic/kibana-app-services
940+
packages/kbn-interpreter @elastic/kibana-visualizations
941941
packages/kbn-io-ts-utils @elastic/apm-ui
942942
packages/kbn-jest-serializers @elastic/kibana-operations
943943
packages/kbn-journeys @elastic/kibana-operations

docs/management/action-types.asciidoc

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -59,6 +59,10 @@ a| <<swimlane-action-type,{swimlane}>>
5959

6060
| Create an incident in {swimlane}.
6161

62+
a| <<tines-action-type,Tines>>
63+
64+
| Send events to a Tines Story.
65+
6266
a| <<webhook-action-type, {webhook}>>
6367

6468
| Send a request to a web service.
Lines changed: 105 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,105 @@
1+
[role="xpack"]
2+
[[tines-action-type]]
3+
== Tines connector
4+
++++
5+
<titleabbrev>Tines</titleabbrev>
6+
++++
7+
8+
The Tines connector uses Tines's https://www.tines.com/docs/actions/types/webhook[Webhook actions] to send events via POST request.
9+
10+
[float]
11+
[[tines-connector-configuration]]
12+
=== Connector configuration
13+
14+
Tines connectors have the following configuration properties.
15+
16+
URL:: The Tines tenant URL. If you are using the <<action-settings, `xpack.actions.allowedHosts`>> setting, make sure the hostname is added to the allowed hosts.
17+
Email:: The email used to sign in to Tines.
18+
API Token:: A Tines API token created by the user. https://www.tines.com/api/authentication#generate-api-token[Docs]
19+
20+
[role="screenshot"]
21+
image::../images/tines-connector.png[Tines connector]
22+
23+
[float]
24+
[[Preconfigured-tines-configuration]]
25+
==== Preconfigured connector type
26+
27+
[source,text]
28+
--
29+
my-tines:
30+
name: preconfigured-tines-connector-type
31+
actionTypeId: .tines
32+
config:
33+
url: https://some-tenant-2345.tines.com
34+
secrets:
35+
email: some.address@test.com
36+
token: ausergeneratedapitoken
37+
--
38+
39+
Config defines information for the connector type.
40+
41+
`url`:: A Tines tenant URL string that corresponds to *URL*.
42+
43+
Secrets defines sensitive information for the connector type.
44+
45+
`email`:: A string that corresponds to *Email*.
46+
`token`:: A string that corresponds to *API Token*.
47+
48+
[float]
49+
[[tines-action-parameters]]
50+
=== Action parameters
51+
52+
Tines action have the following parameters.
53+
54+
Story:: The Story to send the events to.
55+
Webhook:: The Webhook action from the previous story that will receive the events, it is the data entry point.
56+
57+
Test Tines action parameters.
58+
59+
[role="screenshot"]
60+
image::../images/tines-params-test.png[Tines params test]
61+
62+
[float]
63+
[[tines-action-format]]
64+
=== Actions
65+
66+
Once the Tines connector has been configured in an Alerting Rule.
67+
68+
[role="screenshot"]
69+
image::../images/tines-alerting.png[Tines rule alert]
70+
71+
It will send a POST request to the Tines webhook action on every action execution with at least one result.
72+
73+
[float]
74+
[[webhookUrlFallback-tines-configuration]]
75+
==== Webhook URL fallback
76+
77+
It is possible for the requests to the Tines API, to get the stories and webhooks for the selectors, to hit the 500 results limit; in this scenario, the webhook URL fallback text field will be displayed.
78+
Users can still use the selectors if the story or webhook exists in the 500 options loaded. Otherwise, users can paste the webhook URL in the test input field, it can be copied from the Tines webhook configuration.
79+
80+
When the webhook URL is defined, the connector will use it directly in the execution stage, and the story and webhook selectors will be disabled and ignored. To re-enable the story and webhook selectors, remove the webhook URL value.
81+
82+
[role="screenshot"]
83+
image::../images/tines-webhook-url-fallback.png[Tines Webhook URL fallback]
84+
85+
[float]
86+
[[tines-story-library]]
87+
=== Tines Story Libary
88+
89+
In order to simplify the integration with Elastic, Tines offers a set of pre-defined Elastic stories in the Story library.
90+
They can be found by searching for "Elastic" in the Tines Story library:
91+
92+
[role="screenshot"]
93+
image::../images/tines_elastic_stories.png[Tines Elastic stories]
94+
95+
They can be imported directly into your Tines tenant.
96+
97+
=== Format
98+
99+
Tines connector will send the data in JSON format.
100+
101+
The message contains execution specific fields, such as `alertId`, `date`, `_index`, `kibanaBaseUrl`, along with the `rule` and `params` objects.
102+
103+
The number of alerts (signals) can be found at `state.signals_count`.
104+
105+
The alerts (signals) data is stored in the `context.alerts` array, following the https://www.elastic.co/guide/en/ecs/current/ecs-field-reference.html[ECS] format.
76.2 KB
Loading
59.8 KB
Loading
45.5 KB
Loading
33.8 KB
Loading
84.8 KB
Loading

docs/management/connectors/index.asciidoc

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -14,4 +14,5 @@ include::action-types/webhook.asciidoc[]
1414
include::action-types/cases-webhook.asciidoc[leveloffset=+1]
1515
include::action-types/opsgenie.asciidoc[]
1616
include::action-types/xmatters.asciidoc[]
17+
include::action-types/tines.asciidoc[]
1718
include::pre-configured-connectors.asciidoc[]

docs/settings/alert-action-settings.asciidoc

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -131,7 +131,7 @@ A list of allowed email domains which can be used with the email connector. When
131131
WARNING: This feature is available in {kib} 7.17.4 and 8.3.0 onwards but is not supported in {kib} 8.0, 8.1 or 8.2. As such, this setting should be removed before upgrading from 7.17 to 8.0, 8.1 or 8.2. It is possible to configure the settings in 7.17.4 and then upgrade to 8.3.0 directly.
132132

133133
`xpack.actions.enabledActionTypes` {ess-icon}::
134-
A list of action types that are enabled. It defaults to `[*]`, enabling all types. The names for built-in {kib} action types are prefixed with a `.` and include: `.email`, `.index`, `.jira`, `.opsgenie`, `.pagerduty`, `.resilient`, `.server-log`, `.servicenow`, .`servicenow-itom`, `.servicenow-sir`, `.slack`, `.swimlane`, `.teams`, `.xmatters`, and `.webhook`. An empty list `[]` will disable all action types.
134+
A list of action types that are enabled. It defaults to `[*]`, enabling all types. The names for built-in {kib} action types are prefixed with a `.` and include: `.email`, `.index`, `.jira`, `.opsgenie`, `.pagerduty`, `.resilient`, `.server-log`, `.servicenow`, .`servicenow-itom`, `.servicenow-sir`, `.slack`, `.swimlane`, `.teams`, `.tines`, `.xmatters`, and `.webhook`. An empty list `[]` will disable all action types.
135135
+
136136
Disabled action types will not appear as an option when creating new connectors, but existing connectors and actions of that type will remain in {kib} and will not function.
137137

0 commit comments

Comments
 (0)