Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

framework-features-prio #11237

Merged
merged 22 commits into from
Oct 1, 2024
Merged
Show file tree
Hide file tree
Changes from 7 commits
Commits
Show all changes
22 commits
Select commit Hold shift + click to select a range
e71d2f1
framework-features-prio
smeubank Sep 5, 2024
df570a7
Update index.mdx
smeubank Sep 5, 2024
1b04a71
Add vue to nuxt, fix ordering for react and vue
smeubank Sep 5, 2024
c536fdc
test side bar orde config
smeubank Sep 5, 2024
b923c42
Update config.yml
smeubank Sep 5, 2024
11abaca
Update docs/platforms/javascript/guides/nuxt/features/vue-router.mdx
smeubank Sep 9, 2024
9b25436
apply changes
smeubank Sep 9, 2024
7e1499c
Update docs/platforms/javascript/guides/nuxt/features/vue-router.mdx
smeubank Sep 16, 2024
9dea95f
Update docs/platforms/javascript/guides/nuxt/features/component-track…
smeubank Sep 16, 2024
0a75417
Update docs/platforms/javascript/guides/nuxt/features/index.mdx
smeubank Sep 16, 2024
749235d
Update docs/platforms/javascript/guides/nuxt/features/component-track…
smeubank Sep 16, 2024
ec74cca
Update docs/platforms/javascript/guides/nuxt/features/component-track…
smeubank Sep 16, 2024
9df4071
Update docs/platforms/javascript/guides/nuxt/features/component-track…
smeubank Sep 16, 2024
25ff71a
Update docs/platforms/javascript/guides/nuxt/features/component-track…
smeubank Sep 16, 2024
793f122
Update docs/platforms/javascript/guides/nuxt/config.yml
smeubank Sep 16, 2024
9289309
Update docs/platforms/javascript/guides/nuxt/features/component-track…
smeubank Sep 16, 2024
cb7d66b
Update docs/platforms/javascript/guides/nuxt/features/component-track…
smeubank Sep 16, 2024
b67c0e9
Update docs/platforms/javascript/guides/nuxt/features/component-track…
smeubank Sep 16, 2024
ad807ef
Update docs/platforms/javascript/guides/nuxt/features/component-track…
smeubank Sep 16, 2024
476a05f
Update docs/platforms/javascript/guides/react/config.yml
smeubank Sep 16, 2024
762f030
Update docs/platforms/javascript/guides/vue/config.yml
smeubank Sep 16, 2024
b93590d
Update docs/platforms/javascript/guides/nuxt/features/component-track…
smeubank Sep 16, 2024
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
4 changes: 3 additions & 1 deletion docs/platforms/javascript/guides/nuxt/config.yml
Original file line number Diff line number Diff line change
@@ -1,6 +1,8 @@
title: Nuxt
description: Nuxt is a framework for full-stack web apps and websites. Learn how to set it up with Sentry.
sdk: sentry.javascript.nuxt
sidebar_order: 4
smeubank marked this conversation as resolved.
Show resolved Hide resolved
categories:
- javascript
- browser
- server
- server
104 changes: 104 additions & 0 deletions docs/platforms/javascript/guides/nuxt/features/component-tracking.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,104 @@
---
title: Track Vue Components
description: "Learn how Sentry's Nuxt SDK allows you to monitor the rendering performance of your application and its components."
sidebar_order: 10
smeubank marked this conversation as resolved.
Show resolved Hide resolved
---

Sentry's Nuxt SDK offers a feature to monitor the performance of your Vue components: component tracking. Enabling this feature provides you with spans in your transactions that represent the component life cycle events and durations. This allows you to get a drilled-down view into how your components are behaving so you can do things like identify slow initializations or frequent updates, which might have an impact on your app's performance.
smeubank marked this conversation as resolved.
Show resolved Hide resolved
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Sentry's Nuxt SDK offers a feature to monitor the performance of your Vue components: component tracking. Enabling this feature provides you with spans in your transactions that represent the component life cycle events and durations. This allows you to get a drilled-down view into how your components are behaving so you can do things like identify slow initializations or frequent updates, which might have an impact on your app's performance.
Sentry's Nuxt SDK offers a feature to monitor the performance of your Vue components: component tracking. Enabling this feature provides you with spans in your transactions that represent the component lifecycle events and durations. This allows you to get a drilled-down view into how your components are behaving so you can do things like identify slow initializations or frequent updates, which might have an impact on your app's performance.


## Usage

<Alert>

To set up component tracking, you need to configure performance monitoring. For details on how to do this, check out our [Performance documentation](/platforms/javascript/guides/nuxt/performance/).
smeubank marked this conversation as resolved.
Show resolved Hide resolved

</Alert>

### Initial Application Load

By default, the Nuxt SDK tracks the rendering performance of your app (that is, its root component) on the initial page load. This operation is represented in the page load transaction by the **`ui.vue.render`** span.

### Child Components

You can also track your app's child components to get more details about the rendering process. This feature will create spans for each tracked component instance. The spans are called **`ui.vue.[hook]`** where `[hook]` is replaced by each tracked lifecycle stage. For example, the span representing the mount stage (the time between `beforeMount` and `mounted`) is called `ui.vue.mount`.

To set it up, add, at minimum, [`trackComponents`](#trackcomponents) in your `Sentry.init` call. Optionally, you can also add [`hooks`](#hooks), and [`timeout`](#timeout).

smeubank marked this conversation as resolved.
Show resolved Hide resolved
#### `trackComponents`

This is the main option that controls which child components should be tracked. Set it to `true` to track all of them or specify a list of individual components you want to track:

```javascript
Sentry.init({
// ...
trackComponents: true,
// OR
trackComponents: [
"App",
"RwvHeader",
"RwvFooter",
"RwvArticleList",
"Pagination",
],
});
```

The default is `false`.

#### `hooks`

Control which lifecycle hooks should be tracked. This is helpful if, for example, you want to know if some components are removed during the initial page load, in which case you can add a `unmount` hook to the default:
smeubank marked this conversation as resolved.
Show resolved Hide resolved

```javascript
Sentry.init({
// ...
trackComponents: true
hooks: ["mount", "update", "unmount"],
});
```

The following hooks are available to track in Vue 3: `['activate', 'create', 'unmount', 'mount', 'update']`

Note that when specifying `hooks`, we use the simple verb rather than `before` and `-ed` pairs. For example, `unmount` is correct, while `beforeUnmount` and `unmounted` are incorrect.
smeubank marked this conversation as resolved.
Show resolved Hide resolved

<Alert>

In Vue 2, use `destroy` instead of `unmount`. `destroy` does not work in Vue 3, as the names of the lifecycle hooks themselves [changed](https://v3-migration.vuejs.org/breaking-changes/#other-minor-changes) in Vue 3.

</Alert>
smeubank marked this conversation as resolved.
Show resolved Hide resolved

The default set of hooks is `['activate', 'mount', 'update']`.

#### `timeout`

You can specify how long the root rendering span should wait for the last component to render.
Every new rendering cycle debounces the timeout, and it starts counting from the beginning. Once the timeout is reached, tracking is completed, and all the rendering information is sent to Sentry:
smeubank marked this conversation as resolved.
Show resolved Hide resolved

```javascript
Sentry.init({
// ...
trackComponents: true,
timeout: 500,
});
```

The default is `2000`.

#### Alternative Configuration With `tracingOptions`

You can also group the component tracking options by using the optional `tracingOptions` property in `Sentry.init`:
smeubank marked this conversation as resolved.
Show resolved Hide resolved

```javascript
Sentry.init({
// ...
tracingOptions: {
trackComponents: true;
timeout: 500;
hooks: ['mount', 'update'];
}
})
```

Note that when you use this property there is no change in behaviour, as opposed to when you use the three top-level properties described above.
smeubank marked this conversation as resolved.
Show resolved Hide resolved

The default value for `tracingOptions` is `undefined`.
9 changes: 9 additions & 0 deletions docs/platforms/javascript/guides/nuxt/features/index.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,9 @@
---
title: Vue Features
description: "Learn how Sentry's Nuxt SDK exposes features for first class integration with Vue."
smeubank marked this conversation as resolved.
Show resolved Hide resolved
sidebar_order: 4
---

The Sentry Nuxt SDK offers Vue-specific features for first class integration with the framework.

<PageGrid />
9 changes: 9 additions & 0 deletions docs/platforms/javascript/guides/nuxt/features/vue-router.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,9 @@
---
title: Vue Router
description: "Learn about Sentry's Vue Routing integration."
---

Nuxt uses the `vue-router` under the hood, and our Nuxt SDK instruments your routing automatically, to parameterize transaction according to your routes.
smeubank marked this conversation as resolved.
Show resolved Hide resolved

<SignInNote />

1 change: 1 addition & 0 deletions docs/platforms/javascript/guides/react/config.yml
Original file line number Diff line number Diff line change
@@ -1,6 +1,7 @@
title: React
description: "Learn about Sentry's React SDK and how it automatically reports errors and exceptions in your application."
sdk: sentry.javascript.react
sidebar_order: 4
smeubank marked this conversation as resolved.
Show resolved Hide resolved
categories:
- javascript
- browser
1 change: 1 addition & 0 deletions docs/platforms/javascript/guides/react/features/index.mdx
Original file line number Diff line number Diff line change
@@ -1,6 +1,7 @@
---
title: React Features
description: "Learn how Sentry's React SDK exposes custom components for first class integration with the React framework."
sidebar_order: 4
---

The Sentry React SDK offers React-specific features for first class integration with the framework.
Expand Down
1 change: 1 addition & 0 deletions docs/platforms/javascript/guides/vue/config.yml
Original file line number Diff line number Diff line change
@@ -1,5 +1,6 @@
title: Vue
sdk: sentry.javascript.vue
sidebar_order: 4
smeubank marked this conversation as resolved.
Show resolved Hide resolved
categories:
- javascript
- browser
2 changes: 1 addition & 1 deletion docs/platforms/javascript/guides/vue/features/index.mdx
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
title: Vue Features
description: "Learn how Sentry's Vue SDK exposes features for first class integration with Vue."
excerpt: ""
sidebar_order: 4
---

The Sentry Vue SDK offers Vue-specific features for first class integration with the framework.
Expand Down
Loading