End-to-End Monitoring: Profiles
Overview
Use this page to create and manage end-to-end monitoring profiles. A monitoring profile groups the infrastructure health checks, such as CPU, memory, disk, and network metrics, that track one target environment, for example a Citrix farm or a web application. Profiles let you organize these checks by environment instead of by individual machine, within your license's monitoring-agent limit.
Before you create a profile, its monitoring agents must already be registered on the Platform Agents page, since a profile assigns existing agents rather than creating new ones. Once enabled, a profile's checks feed the End-to-End Monitoring dashboard, and you can bind it to a schedule to control when it runs.
This page lists every profile as a card showing its technology badge, assigned agent count, description, and last-updated date. From here you open the creation flow for a new profile, edit or view an existing one, enable or disable its checks, delete it, and read the license banner for your remaining monitoring-agent capacity.
Key concepts
- Monitoring profile - A configuration that groups the infrastructure health checks for one target environment, such as a Citrix farm or a web application. (related: End-to-End Monitoring: Dashboard)
- Monitoring agent - A licensed unit of monitoring capacity that a profile uses to run its checks. Your license caps the total number available across all profiles. (related: Configuration: End-to-End Monitoring: Platform Agents)
- Technology badge - A label on each profile card showing which kind of environment the profile targets, such as Citrix or Web. It determines whether the profile can be opened for editing.
- Active profile - A profile whose status toggle is enabled, so its assigned agents count toward the license banner's in-use total and its checks run on schedule. (related: End-to-End Monitoring: Schedules)
When to use it
- You need to check how many monitoring agents your license allows and how many are already in use before creating or enabling a profile.
- You're setting up monitoring for a new environment, such as a newly added Citrix farm or a web application, for example a target named svc.lg.crane.
- An existing profile's checks or assigned agents need to change, which you do through its edit action instead of recreating the profile.
- You want to pause monitoring for an environment temporarily without losing its configuration.
- A profile is no longer needed and should be removed.
- You want to inspect a profile's configuration without risking an accidental change.
Before you begin
- At least one monitoring agent must be available under your license. Check the license banner at the top of this page for your current total and in-use figures.
- The monitoring agents a new profile will use must already be registered on the Configuration: End-to-End Monitoring: Platform Agents page.
- Know which environment technology, such as Citrix or Web, the profile will target, since this determines which creation flow and badge apply to it.
Common workflows
Check monitoring agent capacity before creating a profile
Persona: Load-test admin
- Open the Profiles page.
- Expect: The page lists existing monitoring profiles as cards, with the license banner at the top showing the total agents your license allows and how many are in use.
- Read the license banner.
- Expect: You see the total monitoring agents allowed and the number currently in use across active profiles.
- Compare the in-use figure to the total.
- Expect: No on-page change; you now know whether creating or re-enabling a profile would exceed your licensed agent count.
Verify: You can state how many spare monitoring agents your license has left before clicking New Profile.
Pause a profile without deleting it
Persona: Monitoring operator
- Locate the profile's card in the grid.
- Expect: The card shows the profile's technology badge, agent count, description, and last-updated date.
- Click the status toggle in the card's top-right corner.
- Expect: The toggle switches state, and the profile's agents are added to or removed from the license banner's in-use total. If the profile's agents have no workload assigned, an inline error appears instead and the toggle does not change.
Verify: The card's toggle shows the new state, and the license banner's in-use count reflects the change.
Steps
Step 1
Open Profiles from the Monitoring and Uptime area.
Expected result: The Monitoring Profiles page loads, listing existing profiles as cards, for example Citrix Infrastructure Health and LoadGen Demo Monitoring, each with a technology badge, description, agent count, and last-updated date, plus a license banner showing the total and in-use monitoring agents.
This page is the starting point for creating, reviewing, and managing end-to-end monitoring profiles.
- The license banner at the top reports your total monitoring agents and how many are in use.
- Each profile card shows a technology badge, an agent count, and a status toggle in the top-right corner.
Column reference
| Column | What it shows | How to read it |
|---|---|---|
| Profile name | Identifies the monitoring profile in the list and anywhere else it is referenced. | Read it as the profile's display name, set when the profile was created. |
| Technology badge | Shows which environment type the profile monitors. Citrix and Web profiles can be opened for editing; a badge reading Unsupported means the profile targets an environment type this build does not recognize, so editing is unavailable until the platform is updated. | Citrix or Web means normal edit access; Unsupported means the pencil icon is missing and only view, enable/disable, and delete remain. |
| Description | Summarizes what the profile monitors. Longer text is truncated with an ellipsis on the card. | If the text ends in an ellipsis, open the view (eye) action to read the full description. |
| Agent count | Shows how many of your licensed monitoring agents are currently assigned to the profile. A count of 0 means the profile is not yet monitoring anything. | Compare this number against the license banner's total to judge how much agent capacity the profile consumes. |
| Last updated | Shows when the profile's configuration was last changed. | An old date on a profile you rely on can indicate it is due for review. |
| Status indicator | Shows whether the profile is enabled (actively collecting data) or disabled (paused). A disabled profile's checks do not run even if agents are still assigned to it. | An unfilled, gray toggle means the profile is disabled; its agents do not count toward the license banner's in-use total even though they are listed on the card. |
| License usage banner | Reports the total monitoring agents your license allows and how many are currently in use across active (enabled) profiles. | Compare the in-use figure to the total to see how much agent capacity remains before you create or enable another profile. |
Controls reference
Refresh
Reloads the profile list and the license usage banner.
When to use: Use after another administrator may have added, changed, or removed a profile, or to confirm the current state after a toggle or delete action.
Side effects: Read-only: re-fetches current data without changing any profile.
New Profile
Opens the creation flow for a new end-to-end monitoring profile.
When to use: Use when you need to start monitoring a new target environment and the license banner shows spare agent capacity.
Side effects: Navigates to the creation flow; no profile is created until you complete and save it there.
Edit profile (pencil icon)
Opens the selected profile in the edit flow with its current settings.
When to use: Use to change a profile's assigned agents, checks, or description.
Side effects: Navigates away from this page; changes take effect only once saved in the edit flow. Not available on profiles whose technology badge reads Unsupported.
View profile (eye icon)
Opens a read-only view of the profile's configuration.
When to use: Use to review a profile's setup without risking a change, including Unsupported profiles where edit is unavailable.
Side effects: Read-only: navigates to a details view, no configuration is changed.
Delete profile (trash icon)
Opens a confirmation dialog and, once confirmed, permanently removes the profile.
When to use: Use when a profile is no longer needed.
Side effects: Mutating: the profile and its configuration are removed and its agents become available for other profiles. This cannot be undone.
Enable/disable toggle (circle icon)
Switches the profile between enabled (active, collecting data) and disabled (paused).
When to use: Disable a profile to free its agents or pause its checks without deleting the configuration; enable it again to resume monitoring.
Side effects: Mutating: changes the profile's active status immediately and updates the license banner's in-use total. Enabling can fail with an on-page error if the profile's agents have no workload assigned.
Verify the result
You've successfully managed a monitoring profile when its card appears in the grid with the correct technology badge, the expected agent count, and a status toggle matching the state you intended (filled for enabled, unfilled for disabled). The license banner's in-use figure rises or falls by the number of agents on profiles you enable or disable. If a profile you just created or edited doesn't appear with the expected settings, click Refresh to confirm the list reflects the latest state. If enabling a profile fails, check that its agents have a workload assigned.
Troubleshooting
- Symptom: Clicking the status toggle to enable a profile shows an inline error instead of switching on. Fix: Assign a workload to the profile's agents first, then try the toggle again.
- Symptom: A profile's technology badge reads Unsupported and the edit (pencil) icon is missing. Fix: This happens when the profile's target environment type isn't recognized by your current platform version. Use view, enable/disable, or delete instead; edit access returns after the platform is updated.
- Symptom: The license banner's in-use count is lower than you expect given the agents assigned to your profiles. Fix: Check each profile's status toggle. Only agents on enabled profiles count toward the in-use total, so a disabled profile's agents are excluded even though they're still assigned.
- Symptom: A profile shows agents assigned but no monitoring data appears. Fix: Check the status toggle in the card's top-right corner. An unfilled toggle means the profile is disabled and its checks don't run, regardless of how many agents are listed on it.
- Symptom: A profile you expect to see is missing from the list. Fix: Click Refresh to reload the list in case another administrator recently added, changed, or deleted it.
Related articles
- Prerequisite: Configuration: End-to-End Monitoring: Platform Agents - Monitoring agents must be registered there before a profile can be assigned to use them.
- Next step: End-to-End Monitoring: Dashboard - View the health metrics collected by enabled profiles.
- Next step: End-to-End Monitoring: Schedules - Control when a profile's checks run.
- See also: Configuration: End-to-End Monitoring: Schedule Definitions - Define the reusable schedules that profiles can be bound to.
- See also: Infrastructure: Licensing - Review or change the monitoring-agent allowance shown in the license banner.