Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
47 changes: 35 additions & 12 deletions docs/reference/edot-android/getting-started.md
Original file line number Diff line number Diff line change
Expand Up @@ -23,7 +23,7 @@

| Requirement | Minimum version |
|---------------------------------------------------|-----------------------------------------------------------------------------------------------------------|
| [{{stack}}](https://www.elastic.co/elastic-stack) | 8.18 |
| [{{stack}}](https://www.elastic.co/elastic-stack) | 8.19 or 9.1 |
| Android API level | 26 (or 21 with [desugaring](https://developer.android.com/studio/write/java8-support#library-desugaring)) |

:::{important}
Expand Down Expand Up @@ -92,26 +92,49 @@

### Visualize telemetry

After your app has sent telemetry data, either [manually](manual-instrumentation.md) or [automatically](automatic-instrumentation.md), view it in {{kib}} by navigating to **Applications**, **Service Inventory**, or by searching for `Service Inventory` in the [global search field](docs-content://explore-analyze/find-and-organize/find-apps-and-objects.md). You should find your application listed there.
After your app has sent telemetry data, either [manually](manual-instrumentation.md) or [automatically](automatic-instrumentation.md), you can visualize it in {{kib}} using the **Android OpenTelemetry Assets** content package.

:::{image} images/span-visualization/1.png
:alt: Services
:width: 350px
#### Install the content package

1. In {{kib}}, search for **Integrations** in the [global search field](docs-content://explore-analyze/find-and-organize/find-apps-and-objects.md).
2. Search for **Android OpenTelemetry Assets**.
3. Open it and click **Install** to add the Android dashboards to your {{kib}} instance.

#### Explore your data in the dashboard

Once the content package is installed, open the **[Android OTel] Application Overview** dashboard:

1. In {{kib}}, search for **Dashboards** in the [global search field](docs-content://explore-analyze/find-and-organize/find-apps-and-objects.md).
2. Search for **Android OTel** and open the **[Android OTel] Application Overview** dashboard.
3. Select your application from the **Applications** panel at the top of the dashboard.

:::{image} images/span-visualization/application-overview-dashboard.png
:alt: Application Overview Dashboard
:screenshot:
:::

The dashboard provides a high-level view of your app's health, including span performance, crash analysis, and session-level insights.

#### View trace waterfall details

To inspect individual span traces in detail, go to a panel that shows a list of spans in the dashboard and click its **Explore in Discover** button.

:::{image} images/span-visualization/explore-spans-in-discover.png
:alt: Explore in Discover
:screenshot:
:::

When you open it, go to the **Transactions** tab, where you should see your app's "outermost" spans listed.
In Discover, expand the details for one of the spans by clicking the expand icon on the left.

:::{image} images/span-visualization/2.png
:alt: Transactions tab
:width: 350px
:::{image} images/span-visualization/open-span-details.png
:alt: Open span details
:screenshot:
:::

After clicking on the span, you should see it in detail.
You'll see the trace waterfall UI, showing the full span hierarchy and timing. You can expand it to fullscreen and drill down into further details from there.

Check notice on line 134 in docs/reference/edot-android/getting-started.md

View workflow job for this annotation

GitHub Actions / docs-preview / vale

Elastic.WordChoice: Consider using 'refer to (if it's a document), view (if it's a UI element)' instead of 'see', unless the term is in the UI.

:::{image} images/span-visualization/3.png
:alt: Trace sample
:::{image} images/span-visualization/trace-waterfall-ui.png
:alt: Trace waterfall UI
:screenshot:
:::

Expand Down
Binary file not shown.
Binary file not shown.
Binary file not shown.
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.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading