Documentation Grafana Cloud Monitor applications Frontend Observability Instrument View tracking

View tracking

The view tracking instrumentation reports the change of the view meta as an event. This is useful for RUM because you can track when a new view is set.

For example, you can set the following different views for an application:

• The register and login pages can be considered auth views
• The homepage page can be considered a home view
• The users listing and user profile pages can be seen as users views

Using the view tracking instrumentation, you can correlate errors, logs, and events that occurred for a particular user when using a particular section of the application.

In order for the view tracking instrumentation to work correctly, the view meta should be set accordingly.

How to use the view tracking instrumentation

The following view tracking instrumentation is enabled by default. No additional configuration is required.

ts Copy

initializeFaro({
  url: 'https://my-domain.my-tld/collect/{app-key}',
  app: {
    name: 'my-app',
  },
});

To manually include the view instrumentation, use the following getWebInstrumentations helper function.

ts Copy

initializeFaro({
  url: 'https://my-domain.my-tld/collect/{app-key}',
  app: {
    name: 'my-app',
  },
  instrumentations: [...getWebInstrumentations()],
});

Alternatively, if you want to fine-tune which instruments are enabled, you can use the following ViewInstrumentation class.

ts Copy

initializeFaro({
  url: 'https://my-domain.my-tld/collect/{app-key}',
  app: {
    name: 'my-app',
  },
  instrumentations: [new ViewInstrumentation()],
});