Commit graph

134 commits

Author SHA1 Message Date
DeDe Morton
9c180ebae5
[DOCS] Update Observability docs to fix problems found during testing (#175636)
## Summary

Adds fixes that have already been made in the serverless docs.

Closes
https://github.com/elastic/staging-serverless-observability-docs/issues/181

### Checklist

n/a

Co-authored-by: Kibana Machine <42973632+kibanamachine@users.noreply.github.com>
2024-01-29 11:05:21 -08:00
Alberto Delgado Roda
128506c652
[Docs] remove .map from bundle_filepath value (#174834)
Part of
https://github.com/elastic/observability-docs/issues/3354#issuecomment-1849730927

## Summary

`bundle_filepath` should not contain `.map`.
2024-01-16 17:59:23 +01:00
Bryce Buchanan
33c74aeb03
[APM] Mobile crashes & errors (#165892)
## Summary

This PR adds back the `Errors` tab to mobile apm services under the
title `Errors & Crashes`. This new page is split into too sections:
errors, and crashes.

Error Tab:
<img width="1456" alt="Screenshot 2023-10-25 at 10 57 00"
src="20277c31-d88c-44ae-b896-1da4223cb392">

Crashes Tab:
<img width="1454" alt="Screenshot 2023-10-25 at 10 57 35"
src="2b0dea23-cbab-4e68-a14a-c3b14d4bd860">


### Checklist

Delete any items that are not applicable to this PR.

- [x] Any text added follows [EUI's writing
guidelines](https://elastic.github.io/eui/#/guidelines/writing), uses
sentence case text and includes [i18n
support](https://github.com/elastic/kibana/blob/main/packages/kbn-i18n/README.md)
- [x]
[Documentation](https://www.elastic.co/guide/en/kibana/master/development-documentation.html)
was added for features that require explanation or tutorials
- [x] [Unit or functional
tests](https://www.elastic.co/guide/en/kibana/master/development-tests.html)
were updated or added to match the most common scenarios
- [x] Any UI touched in this PR is usable by keyboard only (learn more
about [keyboard accessibility](https://webaim.org/techniques/keyboard/))
- [x] Any UI touched in this PR does not create any new axe failures
(run axe in browser:
[FF](https://addons.mozilla.org/en-US/firefox/addon/axe-devtools/),
[Chrome](https://chrome.google.com/webstore/detail/axe-web-accessibility-tes/lhdoppojpmngadmnindnejefpokejbdd?hl=en-US))
- [x] If a plugin configuration key changed, check if it needs to be
allowlisted in the cloud and added to the [docker
list](https://github.com/elastic/kibana/blob/main/src/dev/build/tasks/os_packages/docker_generator/resources/base/bin/kibana-docker)
- [x] This renders correctly on smaller devices using a responsive
layout. (You can test this [in your
browser](https://www.browserstack.com/guide/responsive-testing-on-local-server))
- [x] This was checked for [cross-browser
compatibility](https://www.elastic.co/support/matrix#matrix_browsers)


### Risk Matrix

Delete this section if it is not applicable to this PR.

Before closing this PR, invite QA, stakeholders, and other developers to
identify risks that should be tested prior to the change/feature
release.

When forming the risk matrix, consider some of the following examples
and how they may potentially impact the change:

### For maintainers

- [ ] This was checked for breaking API changes and was [labeled
appropriately](https://www.elastic.co/guide/en/kibana/master/contributing.html#kibana-release-notes-process)

---------

Co-authored-by: kibanamachine <42973632+kibanamachine@users.noreply.github.com>
Co-authored-by: Katerina <kate@kpatticha.com>
2023-12-01 11:28:49 -07:00
Colleen McGinnis
e5bb85b4b3
[DOCS] Add information on KQL filtering in APM rules (#170257)
Closes https://github.com/elastic/observability-docs/issues/3160

## Summary

Adds information on KQL filtering in APM rules.

### Checklist

- [x] @colleenmcginnis initial draft
- [x] @benakansara review
    * In what version was this initially added? 8.10.0?
- [ ] @colleenmcginnis address feedback, merge
2023-11-02 09:29:54 -05:00
Colleen McGinnis
7b0d842096
[DOCS] Clean up APM UI docs (#169269)
Closes https://github.com/elastic/observability-docs/issues/3292

## Summary

Updates documentation related to the APM UI based on issues found during
the Observability docs bug bash last week.

### Checklist

Delete any items that are not applicable to this PR.

- [x] @colleenmcginnis
[Documentation](https://www.elastic.co/guide/en/kibana/master/development-documentation.html)
was added for features that require explanation or tutorials:
- [x] Clarify that distributed traces aren't the only colorful traces in
[Trace sample
timeline](https://www.elastic.co/guide/en/kibana/current/spans.html#distributed-tracing)
(b707c3936b)
- [x] Clarify the implications of the traces table only showing root
transactions in
[Traces](https://www.elastic.co/guide/en/kibana/current/traces.html)
(c1de678f91)
- [x] Add beta admonition to APM
[Infrastucture](https://www.elastic.co/guide/en/kibana/current/infrastructure.html)
page
(d3bc4a972d)
- [x] @bmorelli25 review
2023-10-19 09:42:45 -05:00
Brandon Morelli
ddf1db09f9
[docs] Explain max payload size in RUM source map docs (#165732)
## Summary

Closes https://github.com/elastic/observability-docs/issues/3021.
2023-09-12 08:22:08 -07:00
LikeTheSalad
0e982807e0
Reverting android upload map file endpoint changes (#165449)
## Summary

Closes https://github.com/elastic/kibana/issues/165393


### Checklist

### Risk Matrix

### For maintainers

- [ ] This was checked for breaking API changes and was [labeled
appropriately](https://www.elastic.co/guide/en/kibana/master/contributing.html#kibana-release-notes-process)
2023-09-04 17:07:04 +03:00
LikeTheSalad
6751324a80
Adding endpoint to upload android map files (#161252)
## Summary

We need a way to decode Android crash's stacktraces so that they can
provide meaningful insights to our customers, this is because, due to
security reasons, android apps tend to obfuscate their code before
publishing it online, making crash reports contain obfuscated names,
which don't make any sense before mapping them to the actual source code
names.

In order to help our customers deobfuscate their stacktraces, we need to
allow them to provide us with an R8 map file, which is generated by the
code obfuscation tool (R8) at compile time. This map file is needed to
later do the deobfuscation process.

So these code changes take care of adding a new endpoint that our
customers can use to upload their map files, similarly to what's
currently available to [RUM
Sourcemaps](https://www.elastic.co/guide/en/apm/guide/current/source-map-how-to.html#source-map-rum-upload),
the Android map files will be uploaded to ES, using the same index as
the one currently used to store RUM Sourcemaps.

There's a couple of reasons why a new endpoint to upload android maps is
needed instead of re-using the existing RUM Sourcemaps one:
* The Sourcemaps upload endpoint has validations in place to check the
sourcemap format, which must be a JSON with some expected keys
available. Android map files don't have a JSON format, so they are
rejected by the sourcemaps endpoint.
* Android map files tend to be large in size, just as an example, the
map file generated for our [sample
app](https://github.com/elastic/opbeans-android) has a size of ~7 MB, so
for real apps this number can be larger, which would also cause issues
with the RUM upload endpoint since it has a max file limit size of 1 MB.
* The RUM upload endpoint contains a parameter (`bundle_filepath `) that
doesn't have an equivalent for the android map use case.

This PR depends on https://github.com/elastic/kibana/pull/161152

### Checklist

Delete any items that are not applicable to this PR.

- [x] [Unit or functional
tests](https://www.elastic.co/guide/en/kibana/master/development-tests.html)
were updated or added to match the most common scenarios

### For maintainers

- [ ] This was checked for breaking API changes and was [labeled
appropriately](https://www.elastic.co/guide/en/kibana/master/contributing.html#kibana-release-notes-process)

---------

Co-authored-by: kibanamachine <42973632+kibanamachine@users.noreply.github.com>
Co-authored-by: Søren Louv-Jansen <sorenlouv@gmail.com>
Co-authored-by: Brandon Morelli <bmorelli25@gmail.com>
Co-authored-by: Katerina Patticha <kate@kpatticha.com>
2023-08-01 09:06:59 +02:00
Giorgos Bamparopoulos
3b75103f2b
[APM] Update Storage Explorer docs (#162163)
Updates docs for storage explorer.

Closes https://github.com/elastic/observability-docs/issues/2960
Closes https://github.com/elastic/kibana/issues/151302

Co-authored-by: Kibana Machine <42973632+kibanamachine@users.noreply.github.com>
2023-07-20 09:29:54 +01:00
Brandon Morelli
3ced121be0
[APM] UX text review (#161400)
## Summary

@gchaps and I met to review text on some APM UI pages. Outcomes:

1. Service **m**ap or Service **M**ap — there is inconsistency in the
APM UI with how we refer to Service maps. In some cases, we use title
case (Service Map). In others, we use sentence case (Service map). As
per the [EUI writing
guidelines](https://eui.elastic.co/#/guidelines/writing/guidelines#capitalization),
we should use title case for product features.
2. Storage **e**xplorer or Storage **E**xplorer — same story here. We
use title case sometimes and sentence case others. We should use title
case as this is a product feature.
3. Various text enhancements and changes.
2023-07-07 07:41:46 -07:00
Brandon Morelli
9efbd2243c
[APM] Documentation updates (#160951)
### Summary

This PR makes a handful of updates to the APM app documentation:

- [x] **Agent explorer**
- New page
[here](https://kibana_160951.docs-preview.app.elstc.co/guide/en/kibana/master/agent-explorer.html).
  - _Closes https://github.com/elastic/observability-docs/issues/2886_
- [x] **Trace explorer**
- New section
[here](https://kibana_160951.docs-preview.app.elstc.co/guide/en/kibana/master/traces.html#trace-explorer).
  - _Closes https://github.com/elastic/observability-docs/issues/2885_
- [x] **Dependency operations**
- New section
[here](https://kibana_160951.docs-preview.app.elstc.co/guide/en/kibana/master/dependencies.html#dependencies-operations).
  - _Closes https://github.com/elastic/observability-docs/issues/2889_
- [x] **Adds missing settings and APM Labs info**
- We didn't have documentation on how to enable APM Labs. We [do
now](https://kibana_160951.docs-preview.app.elstc.co/guide/en/kibana/master/apm-settings-in-kibana.html#apm-labs).
- I noticed Labs settings were missing from the documentation. Those
have now been added to the [Kibana advanced
settings](https://kibana_160951.docs-preview.app.elstc.co/guide/en/kibana/master/advanced-options.html#observability-advanced-settings).
2023-06-30 11:49:43 -07:00
Brandon Morelli
4ed60697e9
[APM] Documentation updates (#160568)
### Summary

This PR makes a handful of updates to the APM app documentation:

- [x] **Alerts tab, workflow, and grouping**
- Rewrote most of our [alerting
documentation](https://kibana_160568.docs-preview.app.elstc.co/guide/en/kibana/master/apm-alerts.html#apm-alert-view-active)
to explain the new granularity level of alerts, address new alert names,
and explain the different ways to view active alerts.
- Updated the
[Services](https://kibana_160568.docs-preview.app.elstc.co/guide/en/kibana/master/services.html)
documentation to describe the alert badge and link to alerting docs.
  - _Closes https://github.com/elastic/observability-docs/issues/2887_
  - _Closes https://github.com/elastic/observability-docs/issues/2888_
  - _Closes https://github.com/elastic/observability-docs/issues/2878_
- [x] **Infrastructure tab**
- Added a new [top-level
page](https://kibana_160568.docs-preview.app.elstc.co/guide/en/kibana/master/infrastructure.html)
explaining what this page is useful for.
  - _Closes https://github.com/elastic/observability-docs/issues/2892_
- [x] **Log views and correlation**
- Added a new [top-level page
](https://kibana_160568.docs-preview.app.elstc.co/guide/en/kibana/master/logs.html)that
links to our log correlation docs.
- Updated our [transaction
documentation](https://kibana_160568.docs-preview.app.elstc.co/guide/en/kibana/master/transactions.html#transaction-trace-sample)
with new information and a link to our log correlation docs.
  - _Closes https://github.com/elastic/observability-docs/issues/2891_
- [x] **New AWS Lambda metrics**
- Most of the new charts have tooltips explaining what the charts do. I
updated the screenshot and added some additional information to the
[overview](https://kibana_160568.docs-preview.app.elstc.co/guide/en/kibana/master/apm-lambda.html)
to highlight some of the new features of this page.
  - _Closes https://github.com/elastic/observability-docs/issues/2890_
- [x] **New screenshots**
- I updated any screenshots I noticed were outdated while working on the
above content. Screenshot updates are not necessarily related to the
changes described above.
2023-06-30 11:02:58 -07:00
Bryce Buchanan
ff58872368
Added sessionSampleRate to agent configs (#159061)
## Summary

Adds a Mobile specific setting, `SessionSampleRate`. This dictates the
sample rate of all signals (spans, metrics, & logs) on a per-session
basis.

### Checklist

Delete any items that are not applicable to this PR.

- [x] Any text added follows [EUI's writing
guidelines](https://elastic.github.io/eui/#/guidelines/writing), uses
sentence case text and includes [i18n
support](https://github.com/elastic/kibana/blob/main/packages/kbn-i18n/README.md)
- [x]
[Documentation](https://www.elastic.co/guide/en/kibana/master/development-documentation.html)
was added for features that require explanation or tutorials
- [x] [Unit or functional
tests](https://www.elastic.co/guide/en/kibana/master/development-tests.html)
were updated or added to match the most common scenarios

---------

Co-authored-by: kibanamachine <42973632+kibanamachine@users.noreply.github.com>
2023-06-13 07:30:56 -07:00
Brandon Morelli
72c5d5286a
Update APM links (#156460)
This PR updates three APM links. For the failing links in
https://github.com/elastic/apm-server/pull/10560.
2023-05-02 21:42:18 -04:00
Brandon Morelli
d498c2fe74
docs: link to android agent central config docs (#154303)
### Summary

The Android agent officially supports central configuration as of
version 0.4.0. This PR links from the central configuration
documentation to the Android agent config reference. Closes
https://github.com/elastic/observability-docs/issues/2812. cc
@LikeTheSalad
2023-04-03 23:01:36 -04:00
Brandon Morelli
733a6c2244
[APM] 8.7.0 Documentation and screenshot updates (#153140)
### Summary

- Closes https://github.com/elastic/observability-docs/issues/2632.
- Closes https://github.com/elastic/observability-docs/issues/2631.
- Closes https://github.com/elastic/observability-docs/issues/2633.
- Closes https://github.com/elastic/observability-docs/issues/2630.
- Closes https://github.com/elastic/observability-docs/issues/1339.
2023-03-29 10:21:44 -07:00
Brandon Morelli
61992632ec
APM: Update documentation of PHP APM agent support for service maps (#149584) (#149893)
# Backport

This will backport the following commits from `8.6` to `main`:
- [Update documentation of PHP APM agent support for service maps
(#149584)](https://github.com/elastic/kibana/pull/149584)

<!--- Backport version: 8.1.0 -->

### Questions ?
Please refer to the [Backport tool
documentation](https://github.com/sqren/backport)

<!--BACKPORT {commits} BACKPORT-->

Co-authored-by: Emily S <emily.s@elastic.co>
2023-01-30 23:07:39 +01:00
Yngrid Coello
3d3a885ad7
[APM] Show warning if transaction groups are dropped (#148625)
Closes https://github.com/elastic/kibana/issues/146648.

### Changes
- `transaction_detail_link.tsx` prevent navigation to tx details when
bucket name is other and display the warning tooltip
- `xpack.apm.ui.transactionGroupBucketSize` ui setting was removed and
now we have a hardcoded limit of `1000` buckets when querying
transactions.

**After this change**


https://user-images.githubusercontent.com/1313018/214321647-e0ae59d6-0761-4d9e-a0fe-ef21397aeff7.mov


- When kibana limit has been reached
<img width="1391" alt="image"
src="https://user-images.githubusercontent.com/1313018/214321902-05fbfa6c-7c99-4b21-a67b-7e134c14ab73.png">

- When having only `_other`
<img width="1390" alt="image"
src="https://user-images.githubusercontent.com/1313018/214332887-d6fd59a2-d1ef-4b61-b6ed-79a6d458f0a0.png">

### Test instructions
1. Checkout PR branch
2. Execute Synthtrace scenario
    a. For reaching kibana limit callout
        ```
node scripts/synthtrace --clean other_transaction_group_bucket.ts
--scenarioOpts.txGroups=1001
        ```
    b. For `_other` callout
        ```
node scripts/synthtrace --clean other_transaction_group_bucket.ts
        ```

---------

Co-authored-by: Achyut Jhunjhunwala <achyut.jhunjhunwala@elastic.co>
2023-01-30 15:40:25 +01:00
Brandon Morelli
2228086ae6
[APM] docs: SDH documentation updates (#149359)
## Summary

Two small documentation updates based on feedback in recent SDHs.
2023-01-24 14:30:18 -08:00
Shan Mahanama
9efeb436a5
Fix typo (#144302)
## Summary

This PR fixes a typo in the documentation.

Co-authored-by: Brandon Morelli <brandon.morelli@elastic.co>
2022-12-06 22:32:39 -05:00
Lisa Cawley
8086e99478
[DOCS] Fix Rules and Connectors app labels (#145660) 2022-11-22 09:14:31 -08:00
Brandon Morelli
9360a4e5dd
[APM] docs: storage explorer (#143024)
* initial draft

* nit

* docs: add storage explorer privs

* docs: chart and table fixes

* docs: add metrics

* Update docs/apm/apm-app-users.asciidoc

Co-authored-by: Giorgos Bamparopoulos <gbamparop@gmail.com>

Co-authored-by: Giorgos Bamparopoulos <gbamparop@gmail.com>
2022-10-14 12:56:13 -04:00
Brandon Morelli
35879b9006
remove sm (#142668) 2022-10-05 13:06:36 -07:00
Brandon Morelli
4c281a8995
[APM] docs: explain unknown service health (#139672)
* Update machine-learning.asciidoc

* Update docs/apm/machine-learning.asciidoc

Co-authored-by: Giorgos Bamparopoulos <georgios.bamparopoulos@elastic.co>

Co-authored-by: Giorgos Bamparopoulos <georgios.bamparopoulos@elastic.co>
2022-08-30 15:46:33 -07:00
Brandon Morelli
3044cb7ba5
[APM] Document serverless-specific UI (#135178)
Co-authored-by: Alexander Wert <AlexanderWert@users.noreply.github.com>
2022-07-15 06:34:57 +09:30
István Zoltán Szabó
4f135d7d58
[DOCS] Adds Expected bounds comparison docs (#134472)
Co-authored-by: Lisa Cawley <lcawley@elastic.co>
2022-06-16 18:14:56 +02:00
Brandon Morelli
3b7c8a0c93
docs: fix tab bug (#133680)
Co-authored-by: Kibana Machine <42973632+kibanamachine@users.noreply.github.com>
2022-06-13 22:23:38 -04:00
Brandon Morelli
f120dfb77d
docs: APM spaces (#132071)
* docs: APM spaces

* docs: use filtered aliases instead

* docs: a brief note on namespaces

* docs: alphabetize the list

* Update docs/apm/apm-spaces.asciidoc

Co-authored-by: Søren Louv-Jansen <sorenlouv@gmail.com>

Co-authored-by: Søren Louv-Jansen <sorenlouv@gmail.com>
2022-06-02 15:06:00 -04:00
Avinash Upadhyaya K R
aac3420e40
docs: fix link to distributed tracing origins (#132912) 2022-05-26 12:44:01 +01:00
Søren Louv-Jansen
c1b77b93b6
[APM] Remove mentions of apm_user (#132790) 2022-05-25 12:07:00 +02:00
Brandon Morelli
ea12c46bcf
[APM] docs: add service groups (#132070)
Co-authored-by: Cauê Marcondes <55978943+cauemarcondes@users.noreply.github.com>
Co-authored-by: Kibana Machine <42973632+kibanamachine@users.noreply.github.com>
2022-05-17 09:29:57 -07:00
Brandon Morelli
97301c7d6c
docs: clarify privileges in api key api (#127675) 2022-03-15 12:39:30 -07:00
Tobias Stadler
fc6897c17b
Fixed some typos (#125802)
Co-authored-by: Kibana Machine <42973632+kibanamachine@users.noreply.github.com>
Co-authored-by: Kaarina Tungseth <kaarina.tungseth@elastic.co>
2022-03-02 16:40:34 -06:00
Lisa Cawley
77636e73a9
[DOCS] Remove beta from APM failed transaction correlations (#126003) 2022-02-17 14:22:53 -08:00
Tobias Stadler
d68a0d390a
[APM] Improve open transaction/span/error in Discover (#125431) 2022-02-16 11:03:29 -06:00
Lisa Cawley
bfbb4a9864
[DOCS] Removes APM NodeJS and RUM Javascript modules (#124180) 2022-02-01 13:28:15 -08:00
Brandon Morelli
b69487bc60
Update troubleshooting.asciidoc (#122397)
* Update troubleshooting.asciidoc

* Update troubleshooting.asciidoc

Co-authored-by: Kibana Machine <42973632+kibanamachine@users.noreply.github.com>
2022-01-18 11:53:47 -08:00
DeDe Morton
98f531c343
Remove config template link (#123072) 2022-01-14 13:26:55 -05:00
Giorgos Bamparopoulos
329aaac0a8
[APM] Add documentation for the agent keys API in the APM app (#120787)
* Add documentation for the agent keys API in the APM app

Co-authored-by: Brandon Morelli <bmorelli25@gmail.com>
Co-authored-by: Søren Louv-Jansen <sorenlouv@gmail.com>
Co-authored-by: Kibana Machine <42973632+kibanamachine@users.noreply.github.com>
2021-12-16 10:48:36 +02:00
ymao1
3de6de98a7
[Alerting][Docs] Review usages of Alerting vs alerting (#119314)
* Alerting vs alerting

* PR feedback

* Reverting unnecessary changes

* Apply suggestions from code review

Co-authored-by: gchaps <33642766+gchaps@users.noreply.github.com>

* PR feedback

* PR feedback

* Removing {kib}

* Apply suggestions from code review

Co-authored-by: gchaps <33642766+gchaps@users.noreply.github.com>

* Removing {kib}

Co-authored-by: gchaps <33642766+gchaps@users.noreply.github.com>
Co-authored-by: Kibana Machine <42973632+kibanamachine@users.noreply.github.com>
2021-11-30 19:24:45 -05:00
Brandon Morelli
c32a2f9cbd
[APM] docs: Update setup page and remove index pat docs (#120025) 2021-11-30 14:47:14 -08:00
Lisa Cawley
7c8b6b6f9e
[DOCS] Refresh APM correlation screenshots (#116723) (#118577) 2021-11-15 13:07:22 -08:00
Brandon Morelli
2daadc0d74
docs: update links to APM docs (#115664) 2021-10-20 09:43:30 -07:00
Brandon Morelli
77ad8fe991
docs: fix config names (#114903) 2021-10-13 14:21:50 -07:00
Giorgos Bamparopoulos
767f007bb3
Update namespace for indices (#114612)
* Update namespace for indices

* Update default index for transactions

Co-authored-by: Søren Louv-Jansen <sorenlouv@gmail.com>
2021-10-13 15:57:31 +01:00
Brandon Morelli
2f7e0afed9
docs: remove link to APM Server (#114038) 2021-10-05 20:18:48 -04:00
Brandon Morelli
bc1c6dca47
docs: 7:15 APM updates (#112775) 2021-09-23 11:52:10 -07:00
Lisa Cawley
fdc7aac4aa
[DOCS] APM failed transaction correlations (#111219) 2021-09-09 08:28:05 -07:00
Lisa Cawley
a82f6ca20e
[DOCS] Latency correlations (#110557) 2021-09-01 12:34:48 -07:00
Brandon Morelli
700f6d9394
docs: remove tabbed widget code (#109944) 2021-08-25 13:01:31 -07:00