Skip to content

Commit

Permalink
Merge branch 'master' into tune-dashboard-tests
Browse files Browse the repository at this point in the history
  • Loading branch information
kibanamachine committed Mar 18, 2021
2 parents d70784d + 95b7635 commit 7f99e7b
Show file tree
Hide file tree
Showing 431 changed files with 8,904 additions and 2,962 deletions.
1 change: 1 addition & 0 deletions .github/CODEOWNERS
Validating CODEOWNERS rules …
Original file line number Diff line number Diff line change
Expand Up @@ -99,6 +99,7 @@
/src/plugins/dashboard/ @elastic/kibana-presentation
/src/plugins/input_control_vis/ @elastic/kibana-presentation
/src/plugins/vis_type_markdown/ @elastic/kibana-presentation
/src/plugins/presentation_util/ @elastic/kibana-presentation
/test/functional/apps/dashboard/ @elastic/kibana-presentation
/x-pack/plugins/canvas/ @elastic/kibana-presentation
/x-pack/plugins/dashboard_enhanced/ @elastic/kibana-presentation
Expand Down
2 changes: 1 addition & 1 deletion api_docs/data.json
Original file line number Diff line number Diff line change
Expand Up @@ -27594,4 +27594,4 @@
}
]
}
}
}
2 changes: 1 addition & 1 deletion api_docs/data_search.json
Original file line number Diff line number Diff line change
Expand Up @@ -19470,4 +19470,4 @@
}
]
}
}
}
35 changes: 10 additions & 25 deletions api_docs/discover.json
Original file line number Diff line number Diff line change
Expand Up @@ -911,21 +911,6 @@
"interfaces": [],
"enums": [],
"misc": [
{
"tags": [],
"id": "def-common.AGGS_TERMS_SIZE_SETTING",
"type": "string",
"label": "AGGS_TERMS_SIZE_SETTING",
"description": [],
"source": {
"path": "src/plugins/discover/common/index.ts",
"lineNumber": 11
},
"signature": [
"\"discover:aggs:terms:size\""
],
"initialIsOpen": false
},
{
"tags": [],
"id": "def-common.CONTEXT_DEFAULT_SIZE_SETTING",
Expand All @@ -934,7 +919,7 @@
"description": [],
"source": {
"path": "src/plugins/discover/common/index.ts",
"lineNumber": 16
"lineNumber": 15
},
"signature": [
"\"context:defaultSize\""
Expand All @@ -949,7 +934,7 @@
"description": [],
"source": {
"path": "src/plugins/discover/common/index.ts",
"lineNumber": 17
"lineNumber": 16
},
"signature": [
"\"context:step\""
Expand All @@ -964,7 +949,7 @@
"description": [],
"source": {
"path": "src/plugins/discover/common/index.ts",
"lineNumber": 18
"lineNumber": 17
},
"signature": [
"\"context:tieBreakerFields\""
Expand Down Expand Up @@ -994,7 +979,7 @@
"description": [],
"source": {
"path": "src/plugins/discover/common/index.ts",
"lineNumber": 14
"lineNumber": 13
},
"signature": [
"\"doc_table:hideTimeColumn\""
Expand All @@ -1009,7 +994,7 @@
"description": [],
"source": {
"path": "src/plugins/discover/common/index.ts",
"lineNumber": 19
"lineNumber": 18
},
"signature": [
"\"doc_table:legacy\""
Expand All @@ -1024,7 +1009,7 @@
"description": [],
"source": {
"path": "src/plugins/discover/common/index.ts",
"lineNumber": 15
"lineNumber": 14
},
"signature": [
"\"fields:popularLimit\""
Expand All @@ -1039,7 +1024,7 @@
"description": [],
"source": {
"path": "src/plugins/discover/common/index.ts",
"lineNumber": 20
"lineNumber": 19
},
"signature": [
"\"discover:modifyColumnsOnSwitch\""
Expand Down Expand Up @@ -1069,7 +1054,7 @@
"description": [],
"source": {
"path": "src/plugins/discover/common/index.ts",
"lineNumber": 21
"lineNumber": 20
},
"signature": [
"\"discover:searchFieldsFromSource\""
Expand All @@ -1084,7 +1069,7 @@
"description": [],
"source": {
"path": "src/plugins/discover/common/index.ts",
"lineNumber": 13
"lineNumber": 12
},
"signature": [
"\"discover:searchOnPageLoad\""
Expand All @@ -1099,7 +1084,7 @@
"description": [],
"source": {
"path": "src/plugins/discover/common/index.ts",
"lineNumber": 12
"lineNumber": 11
},
"signature": [
"\"discover:sort:defaultOrder\""
Expand Down
2 changes: 1 addition & 1 deletion api_docs/expressions.json
Original file line number Diff line number Diff line change
Expand Up @@ -33883,4 +33883,4 @@
}
]
}
}
}
14 changes: 7 additions & 7 deletions api_docs/lens.json
Original file line number Diff line number Diff line change
Expand Up @@ -330,7 +330,7 @@
"description": [],
"source": {
"path": "x-pack/plugins/lens/public/indexpattern_datasource/types.ts",
"lineNumber": 72
"lineNumber": 73
},
"signature": [
"Record<string, Pick<",
Expand All @@ -347,7 +347,7 @@
],
"source": {
"path": "x-pack/plugins/lens/public/indexpattern_datasource/types.ts",
"lineNumber": 71
"lineNumber": 72
},
"initialIsOpen": false
},
Expand Down Expand Up @@ -483,7 +483,7 @@
],
"source": {
"path": "x-pack/plugins/lens/public/plugin.ts",
"lineNumber": 88
"lineNumber": 90
},
"signature": [
"React.ComponentType<",
Expand All @@ -509,7 +509,7 @@
],
"source": {
"path": "x-pack/plugins/lens/public/plugin.ts",
"lineNumber": 97
"lineNumber": 99
},
"signature": [
"(input: ",
Expand All @@ -533,7 +533,7 @@
],
"source": {
"path": "x-pack/plugins/lens/public/plugin.ts",
"lineNumber": 101
"lineNumber": 103
},
"signature": [
"() => boolean"
Expand All @@ -542,7 +542,7 @@
],
"source": {
"path": "x-pack/plugins/lens/public/plugin.ts",
"lineNumber": 79
"lineNumber": 81
},
"initialIsOpen": false
},
Expand Down Expand Up @@ -1553,7 +1553,7 @@
"description": [],
"source": {
"path": "x-pack/plugins/lens/public/indexpattern_datasource/types.ts",
"lineNumber": 75
"lineNumber": 76
},
"signature": [
"{ columns: Record<string, IndexPatternColumn>; columnOrder: string[]; incompleteColumns?: Record<string, IncompleteColumn> | undefined; }"
Expand Down
53 changes: 37 additions & 16 deletions docs/apm/advanced-queries.asciidoc
Original file line number Diff line number Diff line change
Expand Up @@ -2,42 +2,63 @@
[[advanced-queries]]
=== Query your data

Querying your APM data is a powerful tool that can make finding bottlenecks in your code even easier.
Imagine you have a user that complains about a slow response time in a specific service.
With the query bar, you can easily filter the APM app to only display trace data for that user,
or, to only show transactions that are slower than a specified time threshold.
Querying your APM data is an essential tool that can make finding bottlenecks in your code even more straightforward.

[float]
==== Example APM app queries
Using the query bar, a powerful data query feature, you can pass advanced queries on your data
to filter on specific pieces of information you’re interested in.

The query bar comes with a handy autocomplete that helps find the fields and even provides suggestions to the data they include.
You can select the query bar and hit the down arrow on your keyboard to begin scanning recommendations.

* Exclude response times slower than 2000 ms: `transaction.duration.us > 2000000`
* Filter by response status code: `context.response.status_code ≥ 400`
* Filter by single user ID: `context.user.id : 12`
[float]
[[apm-app-advanced-queries]]
=== Querying in the APM app

When querying in the APM app, you're merely searching and selecting data from fields in Elasticsearch documents.
Queries entered into the query bar are also added as parameters to the URL,
so it's easy to share a specific query or view with others.
When querying in the APM app, you’re merely searching and selecting data from fields in {es} documents. Queries entered
into the query bar are also added as parameters to the URL, so it’s easy to share a specific query or view with others.

When you type, you can begin to see some of the transaction fields available for filtering:

[role="screenshot"]
image::apm/images/apm-query-bar.png[Example of the Kibana Query bar in APM app in Kibana]

TIP: Read the {kibana-ref}/kuery-query.html[Kibana Query Language Enhancements] documentation to learn more about the capabilities of the {kib} query language.
[TIP]
=====
To learn more about the {kib} query language capabilities, see the {kibana-ref}/kuery-query.html[Kibana Query Language Enhancements] documentation.
=====

[float]
[[apm-app-queries]]
==== APM app queries

APM queries can be handy for removing noise from your data in the <<services,Services>>, <<transactions,Transactions>>,
<<errors,Errors>>, <<metrics,Metrics>>, and <<traces,Traces>> views.

For example, in the *Services* view, you can quickly view a list of all the instrumented services running on your production
environment: `service.environment : production`. Or filter the list by including the APM agent's name and the host it’s running on:
`service.environment : "production" and agent.name : "java" and host.name : "prod-server1"`.

On the *Traces* view, you might want to view failed transaction results from any of your running containers:
`transaction.result :"FAILURE" and container.id : *`.

On the *Transactions* view, you may want to list only the slower transactions than a specified time threshold: `transaction.duration.us > 2000000`.
Or filter the list by including the service version and the Kubernetes pod it's running on:
`transaction.duration.us > 2000000 and service.version : "7.12.0" and kubernetes.pod.name : "pod-5468b47f57-pqk2m"`.

[float]
[[discover-advanced-queries]]
=== Querying in Discover

Alternatively, you can query your APM documents in {kibana-ref}/discover.html[*Discover*].
Querying documents in *Discover* works the same way as querying in the APM app,
Querying documents in *Discover* works the same way as queries in the APM app,
and *Discover* supports all of the example APM app queries shown on this page.

[float]
==== Example Discover query
[[discover-queries]]
==== Discover queries

One example where you may want to make use of *Discover*,
is for viewing _all_ transactions for an endpoint, instead of just a sample.
is to view _all_ transactions for an endpoint instead of just a sample.

TIP: Starting in v7.6, you can view ten samples per bucket in the APM app, instead of just one.

Expand Down
Loading

0 comments on commit 7f99e7b

Please sign in to comment.