Troubleshooting

If you need help managing transactions, you can read more here. If you need additional help, you can ask on GitHub. Customers on a paid plan may also contact support.

Group Transactions

When Sentry captures transactions, they are assigned a transaction name. This name is generally auto-generated by the Sentry SDK based on the framework integrations you are using. If you can't leverage the automatic transaction generation (or want to customize how transaction names are generated) you can use a global event processor that is registered when you initialize the SDK with your configuration.

For example:

// All JavaScript-based SDKs include this function, so it's safe to replace `@sentry/node`
// with your particular SDK
import {addEventProcessor} from '@sentry/node';

addEventProcessor(event => {
  if (event.type === 'transaction') {
    event.transaction = sanitizeTransactionName(event.transaction);
  }
  return event;
});

Control Data Truncation

Currently, every tag has a maximum character limit of 200 characters. Tags over the 200 character limit will become truncated, losing potentially important information. To retain this data, you can split data over several tags instead.

For example, a 200+ character tag like this:

https://empowerplant.io/api/0/projects/ep/setup_form/?user_id=314159265358979323846264338327&tracking_id=EasyAsABC123OrSimpleAsDoReMi&product_name=PlantToHumanTranslator&product_id=161803398874989484820458683436563811772030917980576

...will become truncated to:

https://empowerplant.io/api/0/projects/ep/setup_form/?user_id=314159265358979323846264338327&tracking_id=EasyAsABC123OrSimpleAsDoReMi&product_name=PlantToHumanTranslator&product_id=1618033988749894848

Instead of using tags, it is recommended to add data to spans as attributes. Using span.setAttribute() allows to add data with arbitrary length to a span. You can add as many attributes to your span as you want.

const baseUrl = 'https://empowerplant.io';
const endpoint = '/api/0/projects/ep/setup_form';
const parameters = {
  user_id: 314159265358979323846264338327,
  tracking_id: 'EasyAsABC123OrSimpleAsDoReMi',
  product_name: PlantToHumanTranslator,
  product_id: 161803398874989484820458683436563811772030917980576,
};

startSpan(
  {
    op: 'http.client',
    name: 'setup form',
    // you can add attributes when starting the span
    attributes: {
      baseUrl,
      endpoint,
    },
  },
  span => {
    // or you can add attributes to an existing span
    for (const key of parameters) {
      span.setAttribute(`parameters.${key}`, parameters[key]);
    }

    // do something to be measured
  }
);