-
Notifications
You must be signed in to change notification settings - Fork 8.3k
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Merge branch 'master' into canvas-embeddable-plugin
- Loading branch information
Showing
2,271 changed files
with
92,264 additions
and
53,206 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Validating CODEOWNERS rules …
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,97 @@ | ||
[role="xpack"] | ||
[[apm-alerts]] | ||
=== Create an alert | ||
|
||
beta::[] | ||
|
||
The APM app is integrated with Kibana's {kibana-ref}/alerting-getting-started.html[alerting and actions] feature. | ||
It provides a set of built-in **actions** and APM specific threshold **alerts** for you to use, | ||
and allows all alerts to be centrally managed from <<management,Kibana Management>>. | ||
|
||
[role="screenshot"] | ||
image::apm/images/apm-alert.png[Create an alert in the APM app] | ||
|
||
There are two different types of threshold alerts: transaction duration, and error rate. | ||
Below, we'll create one of each. | ||
|
||
[float] | ||
[[apm-create-transaction-alert]] | ||
=== Create a transaction duration alert | ||
|
||
This guide creates an alert for the `opbeans-java` service based on the following criteria: | ||
|
||
* Transaction type: `transaction.type:request` | ||
* Average request is above `1500ms` for the last 5 minutes | ||
* Check every 10 minutes, and repeat the alert every 30 minutes | ||
* Send the alert via Slack | ||
|
||
From the APM app, navigate to the `opbeans-java` service and select | ||
**Alerts** > **Create threshold alert** > **Transaction duration**. | ||
|
||
The name of your alert will automatically be set as `Transaction duration | opbeans-java`, | ||
and the alert will be tagged with `apm` and `service.name:opbeans-java`. | ||
Feel free to edit either of these defaults. | ||
|
||
Based on the alert criteria, define the following alert details: | ||
|
||
* **Check every** - `10 minutes` | ||
* **Notify every** - `30 minutes` | ||
* **TYPE** - `request` | ||
* **WHEN** - `avg` | ||
* **IS ABOVE** - `1500ms` | ||
* **FOR THE LAST** - `5 minutes` | ||
|
||
Select an action type. | ||
Multiple action types can be selected, but in this example we want to post to a slack channel. | ||
Select **Slack** > **Create a connector**. | ||
Enter a name for the connector, | ||
and paste the webhook URL. | ||
See Slack's webhook documentation if you need to create one. | ||
|
||
Select **Save**. The alert has been created and is now active! | ||
|
||
[float] | ||
[[apm-create-error-alert]] | ||
=== Create an error rate alert | ||
|
||
This guide creates an alert for the `opbeans-python` service based on the following criteria: | ||
|
||
* Error rate is above 25 for the last minute | ||
* Check every 1 minute, and repeat the alert every 10 minutes | ||
* Send the alert via email to the `opbeans-python` team | ||
|
||
From the APM app, navigate to the `opbeans-python` service and select | ||
**Alerts** > **Create threshold alert** > **Error rate**. | ||
|
||
The name of your alert will automatically be set as `Error rate | opbeans-python`, | ||
and the alert will be tagged with `apm` and `service.name:opbeans-python`. | ||
Feel free to edit either of these defaults. | ||
|
||
Based on the alert criteria, define the following alert details: | ||
|
||
* **Check every** - `1 minute` | ||
* **Notify every** - `10 minutes` | ||
* **IS ABOVE** - `25 errors` | ||
* **FOR THE LAST** - `1 minute` | ||
|
||
Select the **Email** action type and click **Create a connector**. | ||
Fill out the required details: sender, host, port, etc., and click **save**. | ||
|
||
Select **Save**. The alert has been created and is now active! | ||
|
||
[float] | ||
[[apm-alert-manage]] | ||
=== Manage alerts and actions | ||
|
||
From the APM app, select **Alerts** > **View active alerts** to be taken to the Kibana alerts and actions management page. | ||
From this page, you can create, edit, disable, mute, and delete alerts, and create, edit, and disable connectors. | ||
|
||
[float] | ||
[[apm-alert-more-info]] | ||
=== More information | ||
|
||
See {kibana-ref}/alerting-getting-started.html[alerting and actions] for more information. | ||
|
||
NOTE: If you are using an **on-premise** Elastic Stack deployment with security, | ||
TLS must be configured for communication between Elasticsearch and Kibana. | ||
More information is in the alerting {kibana-ref}/alerting-getting-started.html#alerting-setup-prerequisites[prerequisites]. |
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,48 @@ | ||
[[service-maps]] | ||
=== Service maps | ||
|
||
beta::[] | ||
|
||
A service map is a real-time diagram of the interactions occurring in your application’s architecture. | ||
It allows you to easily visualize data flow and high-level statistics, like average transaction duration, | ||
requests per minute, errors per minute, and metrics, allowing you to quickly assess the status of your services. | ||
|
||
Our beta offering creates two types of service maps: | ||
|
||
* Global: All services and connections are shown. | ||
* Service-specific: Selecting a specific service will highlight it's connections. | ||
|
||
[role="screenshot"] | ||
image::apm/images/service-maps.png[Example view of service maps in the APM app in Kibana] | ||
|
||
[float] | ||
[[visualize-your-architecture]] | ||
=== Visualize your architecture | ||
|
||
Select the **Service Map** tab to get started. | ||
By default, all services and connections are shown. | ||
Whether your onboarding a new engineer, or just trying to grasp the big picture, | ||
click around, zoom in and out, and begin to visualize how your services are connected. | ||
|
||
If there's a specific service that interests you, select that service to highlight its connections. | ||
Clicking **Focus map** will refocus the map on that specific service and lock the connection highlighting. | ||
From here, select **Service Details**, or click on the **Transaction** tab to jump to the Transaction overview. | ||
You can also use the tabs at the top of the page to easily jump to the **Errors** or **Metrics** overview. | ||
|
||
While it's not possible to query in service maps, it is possible to filter by environment. | ||
This can be useful if you have two or more services, in separate environments, but with the same name. | ||
Use the environment drop down to only see the data you're interested in, like `dev` or `production`. | ||
|
||
[role="screenshot"] | ||
image::apm/images/service-maps-java.png[Example view of service maps with Java highlighted in the APM app in Kibana] | ||
|
||
[float] | ||
[[service-maps-legend]] | ||
=== Legend | ||
|
||
Nodes appear on the map in one of two shapes: | ||
|
||
* **Circle**: Instrumented services. Interior icons are based on the language of the agent used. | ||
* **Diamond**: Databases, external, and messaging. Interior icons represent the generic type, | ||
with specific icons for known entities, like Elasticsearch. | ||
Type and subtype are based on `span.type`, and `span.subtype`. |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Oops, something went wrong.