-
Notifications
You must be signed in to change notification settings - Fork 8.2k
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Merge remote-tracking branch 'upstream/master' into np-migrate-coordi…
…nate-maps
- Loading branch information
Showing
1,138 changed files
with
32,088 additions
and
9,830 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
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
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
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,38 +1,53 @@ | ||
[role="xpack"] | ||
[[spans]] | ||
=== Span timeline | ||
=== Trace sample timeline | ||
|
||
TIP: A {apm-overview-ref-v}/transaction-spans.html[span] is the duration of a single event. | ||
Spans are automatically captured by APM agents, and you can also define custom spans. | ||
Each span has a type and is defined by a different color in the timeline/waterfall visualization. | ||
|
||
The span timeline visualization is a bird's-eye view of what your application was doing while it was trying to respond to the request that came in. | ||
The trace sample timeline visualization is a bird's-eye view of what your application was doing while it was trying to respond to a request. | ||
This makes it useful for visualizing where the selected transaction spent most of its time. | ||
|
||
[role="screenshot"] | ||
image::apm/images/apm-transaction-sample.png[Example of distributed trace colors in the APM app in Kibana] | ||
|
||
View a span in detail by clicking on it in the timeline waterfall. | ||
When you click on an SQL Select database query, | ||
For example, when you click on an SQL Select database query, | ||
the information displayed includes the actual SQL that was executed, how long it took, | ||
and the percentage of the trace's total time. | ||
You also get a stack trace, which shows the SQL query in your code. | ||
Finally, APM knows which files are your code and which are just modules or libraries that you've installed. | ||
These library frames will be minimized by default in order to show you the most relevant stack trace. | ||
|
||
TIP: A {apm-overview-ref-v}/transaction-spans.html[span] is the duration of a single event. | ||
Spans are automatically captured by APM agents, and you can also define custom spans. | ||
Each span has a type and is defined by a different color in the timeline/waterfall visualization. | ||
|
||
[role="screenshot"] | ||
image::apm/images/apm-span-detail.png[Example view of a span detail in the APM app in Kibana] | ||
|
||
If your span timeline is colorful, it's indicative of a <<distributed-tracing,distributed trace>>. | ||
[float] | ||
[[distributed-tracing]] | ||
==== Distributed tracing | ||
|
||
If your trace sample timeline is colorful, it's indicative of a distributed trace. | ||
Services in a distributed trace are separated by color and listed in the order they occur. | ||
|
||
[role="screenshot"] | ||
image::apm/images/apm-services-trace.png[Example of distributed trace colors in the APM app in Kibana] | ||
|
||
Don't forget; a distributed trace includes more than one transaction. | ||
As application architectures are shifting from monolithic to more distributed, service-based architectures, | ||
distributed tracing has become a crucial feature of modern application performance monitoring. | ||
It allows you to trace requests through your service architecture automatically, and visualize those traces in one single view in the APM app. | ||
From initial web requests to your front-end service, to queries made to your back-end services, | ||
this makes finding possible bottlenecks throughout your application much easier and faster. | ||
|
||
[role="screenshot"] | ||
image::apm/images/apm-distributed-tracing.png[Example view of the distributed tracing in APM app in Kibana] | ||
|
||
Don't forget; by definition, a distributed trace includes more than one transaction. | ||
When viewing these distributed traces in the timeline waterfall, you'll see this image:apm/images/transaction-icon.png[APM icon] icon, | ||
which indicates the next transaction in the trace. | ||
These transactions can be expanded and viewed in detail by clicking on them. | ||
|
||
After exploring these traces, | ||
you can return to the full trace by clicking *View full trace*. | ||
|
||
TIP: Distributed tracing is supported by all APM agents, and there's no additional configuration needed. |
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
24 changes: 24 additions & 0 deletions
24
docs/development/core/public/kibana-plugin-core-public.assertnever.md
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,24 @@ | ||
<!-- Do not edit this file. It is automatically generated by API Documenter. --> | ||
|
||
[Home](./index.md) > [kibana-plugin-core-public](./kibana-plugin-core-public.md) > [assertNever](./kibana-plugin-core-public.assertnever.md) | ||
|
||
## assertNever() function | ||
|
||
Can be used in switch statements to ensure we perform exhaustive checks, see https://www.typescriptlang.org/docs/handbook/advanced-types.html\#exhaustiveness-checking | ||
|
||
<b>Signature:</b> | ||
|
||
```typescript | ||
export declare function assertNever(x: never): never; | ||
``` | ||
|
||
## Parameters | ||
|
||
| Parameter | Type | Description | | ||
| --- | --- | --- | | ||
| x | <code>never</code> | | | ||
|
||
<b>Returns:</b> | ||
|
||
`never` | ||
|
24 changes: 24 additions & 0 deletions
24
docs/development/core/public/kibana-plugin-core-public.deepfreeze.md
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,24 @@ | ||
<!-- Do not edit this file. It is automatically generated by API Documenter. --> | ||
|
||
[Home](./index.md) > [kibana-plugin-core-public](./kibana-plugin-core-public.md) > [deepFreeze](./kibana-plugin-core-public.deepfreeze.md) | ||
|
||
## deepFreeze() function | ||
|
||
Apply Object.freeze to a value recursively and convert the return type to Readonly variant recursively | ||
|
||
<b>Signature:</b> | ||
|
||
```typescript | ||
export declare function deepFreeze<T extends Freezable>(object: T): RecursiveReadonly<T>; | ||
``` | ||
|
||
## Parameters | ||
|
||
| Parameter | Type | Description | | ||
| --- | --- | --- | | ||
| object | <code>T</code> | | | ||
|
||
<b>Returns:</b> | ||
|
||
`RecursiveReadonly<T>` | ||
|
14 changes: 14 additions & 0 deletions
14
docs/development/core/public/kibana-plugin-core-public.freezable.md
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,14 @@ | ||
<!-- Do not edit this file. It is automatically generated by API Documenter. --> | ||
|
||
[Home](./index.md) > [kibana-plugin-core-public](./kibana-plugin-core-public.md) > [Freezable](./kibana-plugin-core-public.freezable.md) | ||
|
||
## Freezable type | ||
|
||
|
||
<b>Signature:</b> | ||
|
||
```typescript | ||
export declare type Freezable = { | ||
[k: string]: any; | ||
} | any[]; | ||
``` |
Oops, something went wrong.