How to use broker with .NET profiler
This article describes how to use connection broker with YourKit .NET Profiler 2022.9 or newer. Please note, that all YourKit .NET Profiler versions prior to 2022.9 (e.g. 2022.3 and older) do not support connections through the broker.
1. Sign up for YourKit Connection Broker account
Before getting started, you need to sign up for YourKit Connection Broker account. You will receive email with the address of your connection broker, and further instructions how to set account password.
After creating the account, please log into it.
2. Create zone
Navigate to the Zones page and click button to create new zone. You will need to provide zone name and optional description. Let's create the zone with Demo zone name.
3. Create token
Now we need an access token to get access to the created Demo zone. In this demo we will create the single token, that will be used by both profiler UI and profiler agent. But you may always create separate access tokens.
To create a token, click button on a Zone page. Specify Demo token as a token name and click Create button. Optionally you may specify token expiration date, if you want to limit its lifespan.
IMPORTANT: Copy the created access token to a safe place, you will need it later. The token is displayed only once after creation. Connection broker does not store tokens as plain text, only hashes, so tokens cannot be recovered.
4. Start profiling
Now you need to add 2 profiler agent startup options:
broker_url- Broker URL which you received by email, and which you use to log into your account.
broker_token- The access token which you have just created.
When you start your .NET application with the profiler agent, it will connect to the Connection Broker. You will see your application in the list of broker connections.
5. Connect with UI
To connect UI to the application and control profiling, use remote profiling feature:
- On Welcome screen click Profile remote application...
- Choose YourKit Connection Broker as an application discovery method.
- Specify provided <broker URL>, and created <access token>.
- After completing the wizard, a new connection will appear in the Monitor Applications list on Welcome screen.