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

feat(angular): Update Angular docs for v7 release #4963

Merged
merged 5 commits into from
May 30, 2022
Merged
Show file tree
Hide file tree
Changes from 2 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
8 changes: 8 additions & 0 deletions src/includes/getting-started-install/javascript.angular.mdx
Original file line number Diff line number Diff line change
@@ -1,3 +1,11 @@
<Alert level="info" title="Angular Version Compatibility" >

The latest version of the Sentry Angular SDK officially supports Angular 10 and newer.
If you are using an older Angular version and you experience problems with the SDK, you can
try using version 6 (at your own risk) until you upgrade your Angular version.

</Alert>

```bash {tabTitle:npm}
npm install --save @sentry/angular @sentry/tracing
```
Expand Down
87 changes: 43 additions & 44 deletions src/platforms/javascript/guides/angular/components/tracehelpers.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,42 @@ title: Track Angular Components

To track Angular components as part of your transactions, use any of these three options:

1. `TraceClassDecorator` tracks a duration between `OnInit` and `AfterViewInit` lifecycle hooks in components:
1. `TraceDirective` tracks a duration between `OnInit` and `AfterViewInit` lifecycle hooks in template:

<Alert level="info" title="Compatibility">

If you're using version 6 of the Angular SDK, using `TraceDirective` or `TraceModule` causes a
compiler error at application compile time of your Angular application. This is a [known issue](https://github.com/getsentry/sentry-javascript/issues/3282)
of our Angular SDK v6 and it was [fixed](https://github.com/getsentry/sentry-javascript/issues/4644)
in v7 of our Angular SDK. We recommend upgrading to the latest Angular SDK version.
Otherwise, please use options 2 (`TraceClassDecorator`) and 3 (`TraceMethodDecorator`)
below to track your Angular components.

</Alert>

Import `TraceModule` either globally in your application's `app.module.ts` file or locally in the module(s)
you want to track your components:

```javascript
import * as Sentry from "@sentry/angular";

@NgModule({
// ...
imports: [Sentry.TraceModule],
// ...
})
export class AppModule {}
```

Then, inside your components template, (remember that the directive name attribute is required):

```html
<app-header [trace]="'header'"></app-header>
<articles-list [trace]="'articles-list'"></articles-list>
<app-footer [trace]="'footer'"></app-footer>
```

2. `TraceClassDecorator` tracks a duration between `OnInit` and `AfterViewInit` lifecycle hooks in components:

```javascript
import { Component } from "@angular/core";
Expand All @@ -20,7 +55,7 @@ export class HeaderComponent {
}
```

2. `TraceMethodDecorator` tracks a specific lifecycle hooks as point-in-time spans in components:
3. `TraceMethodDecorator` tracks a specific lifecycle hooks as point-in-time spans in components:

```javascript
import { Component, OnInit } from "@angular/core";
Expand All @@ -40,20 +75,20 @@ You can also add your own custom spans by attaching them to the current active t
helper. For example, to track the duration of the Angular bootstraping process:

```javascript
import { enableProdMode } from '@angular/core';
import { platformBrowserDynamic } from '@angular/platform-browser-dynamic';
import * as Sentry from '@sentry/angular';
import { enableProdMode } from "@angular/core";
import { platformBrowserDynamic } from "@angular/platform-browser-dynamic";
import * as Sentry from "@sentry/angular";

import { AppModule } from './app/app.module';
import { AppModule } from "./app/app.module";

// ...

const activeTransaction = Sentry.getActiveTransaction();
const bootstrapSpan =
activeTransaction &&
activeTransaction.startChild({
description: 'platform-browser-dynamic',
op: 'ui.angular.bootstrap',
description: "platform-browser-dynamic",
op: "ui.angular.bootstrap",
});

platformBrowserDynamic()
Expand All @@ -66,39 +101,3 @@ platformBrowserDynamic()
}
});
```

3. `TraceDirective` tracks a duration between `OnInit` and `AfterViewInit` lifecycle hooks in template:

<Alert level="warning" title="Important">

Using `TraceDirective` or `TraceModule` currently causes a compiler error at application compile
time of your Angular application if AOT compilation is enabled in your application config (which it is by default).
This is a [known limitation](https://github.com/getsentry/sentry-javascript/issues/3282) of our current
Angular SDK (v6.*) and it will be [adressed and fixed](https://github.com/getsentry/sentry-javascript/issues/4644)
in our next major Angular SDK release (v7).
In the meantime, please use options 1 (`TraceClassDecorator`) and 2 (`TraceMethodDecorator`)
above to track your Angular components.

</Alert>

Import `TraceModule` either globally in your application's `app.module.ts` file or locally in the module(s)
you want to track your components:

```javascript
import * as Sentry from "@sentry/angular";

@NgModule({
// ...
imports: [Sentry.TraceModule],
// ...
})
export class AppModule {}
```

Then, inside your components template, (remember that the directive name attribute is required):

```html
<app-header [trace]="'header'"></app-header>
<articles-list [trace]="'articles-list'"></articles-list>
<app-footer [trace]="'footer'"></app-footer>
```