Skip to main content
Availability8.6.0 or later

Note Basics

Collaborative tickets on data

Note Attachments

Created from Workspace areas

Writing an Effective Note

Explain impact and context

Recommended Workflow

Steps for team handoffs
Notes and Tickets GermainUX includes a built-in ticketing and collaboration system that allows teams to create a Note on any metric, dashboard, individual instance, or user session. A Note turns an insight discovered in GermainUX into an actionable ticket. Teams can document the finding, discuss it through comments, assign responsibility, and follow the investigation without losing the original analytical context. Notes help eliminate the need to repeatedly copy information between GermainUX and external ticketing systems. The issue and the discussion remain connected to the metric or user experience where they were identified.

​
What Is a Note?

A Note is a collaborative ticket attached to GermainUX data. Use a Note to:
  • Comment on a metric or detected issue
  • Document an observation or diagnosis
  • Assign an issue to a user
  • Collaborate through additional comments
  • Preserve the dashboard, metric, instance, or session context
  • Communicate progress and updates
  • Track an issue from discovery through investigation and resolution
When a Note is created or updated, GermainUX automatically emails the relevant users so they can review the change and take action.

​
Why Use Notes?

Monitoring and analytics identify what is happening. Notes help teams coordinate what happens next. For example, a user can:
1

Identify a conversion decline, adoption issue, workflow bottleneck, error, or performance problem

2

Create a Note directly from the affected metric

3

Describe the finding and its potential impact

4

Assign the Note to the person responsible for investigating it

5

Add comments as new evidence becomes available

6

Keep the discussion connected to the original GermainUX data

This creates a continuous workflow from:
DetectionAnalysisAssignmentCollaborationResolution

​
What Can a Note Be Attached To?

Notes can be created from several areas of Germain Workspace.

​
Dashboard

Create a Note from an Aggregate or other supported dashboard to comment on the overall situation represented by that dashboard. This is useful when the issue affects several KPIs or when the Note concerns a broader business or technical condition.

​
Metric

Create a Note directly from a KPI or metric to preserve the selected metric, time range, filters, and analytical context. Examples include:
  • A conversion-rate decline
  • A CRM adoption issue
  • An increase in user-facing errors
  • A slow application transaction
  • A workflow drop-off
  • A productivity loss
  • A service or application availability problem

​
Drill-through Instance

Create a Note from an individual row in a Drill-through Dashboard when the ticket concerns a specific event, transaction, error, or data point. This allows the assignee to return to the exact instance that triggered the investigation.

​
Analysis Dashboard

Create a Note while investigating a KPI or individual instance in the Analysis Dashboard. The Note can document:
  • Whether the KPI is abnormal
  • Related KPIs that changed with it
  • Leading Factors
  • Affected users, sessions, pages, products, or versions
  • Trace findings
  • The suspected root cause
  • Recommended corrective actions

​
Session Replay

Create a Note at the exact moment or UI element where an issue occurs during Session Replay. Notes can be added in two ways:
After a timeline Note is created, a Note indicator appears at the corresponding point in the replay. Hover over the indicator to view the associated message. This allows teams to annotate the precise moment when a user encountered confusion, an error, a delay, a rage click, a dead end, or another experience issue.

​
Create a Note

To create a Note:
1

Open the relevant dashboard, metric, instance, Analysis Dashboard, or Session Replay

2

Select Add Note from the available actions or context menu

3

Enter a clear description of the issue, observation, or requested action

4

Assign the Note to the appropriate user, when applicable

5

Save the Note

The Note remains associated with the GermainUX context from which it was created.

​
Writing an Effective Note

A useful Note should explain: Example:
Salesforce record-view actions are degraded by 45.5% compared with the recent baseline, affecting three users across ten sessions. Analysis indicates increased server wait time on the related Lightning request, accompanied by user-facing errors and rage clicks. Please investigate the backend response-time increase and add the findings to this Note.

​
Assign a Note

A Note can be assigned to a GermainUX user so that responsibility for the next action is clear. Assignment can be used to route work to:
  • Application owners
  • Developers
  • Support teams
  • SRE or operations teams
  • Product managers
  • UX teams
  • Business-process owners
  • Conversion teams
  • Other responsible users
The assignee can review the Note in GermainUX, return to its original context, and add comments or updates.

​
Comment and Collaborate

Users can add comments to an existing Note as the investigation progresses. Comments can be used to:
  • Ask for additional information
  • Record diagnostic findings
  • Share a proposed solution
  • Document corrective actions
  • Confirm that a fix was deployed
  • Record validation results
  • Communicate the current status to other participants
Keeping comments in the Note preserves the history of the investigation alongside the supporting evidence.

​
Email Notifications

GermainUX automatically sends an email when a Note is created or updated. Notifications help assignees and participants remain informed without continuously monitoring the Notes Dashboard. The email directs recipients back to the Note and its associated GermainUX context.

​
Manage Notes

To view and manage all Notes, go to: Germain Workspace > Notes The Notes Dashboard provides a centralized view of tickets created across GermainUX. Use it to:
  • Review existing Notes
  • Find Notes assigned to a user
  • Open the dashboard, metric, instance, or session associated with a Note
  • Read the discussion and investigation history
  • Add comments
  • Update the assignment
  • Continue the investigation

​
1. Detect

Identify an issue through a dashboard, alert, SLA violation, Friction Dashboard, Analysis Dashboard, or Session Replay.

​
2. Analyze

Determine the business impact, affected population, related signals, Leading Factors, and likely cause.

​
3. Create a Note

Create the Note directly from the most relevant metric, instance, or Session Replay moment.

​
4. Assign

Assign the Note to the person responsible for the next action.

​
5. Collaborate

Add findings, questions, decisions, and corrective actions as comments.

​
6. Correct

Implement the appropriate business, UX, workflow, configuration, or technology change.

​
7. Validate

Return to the original metric or session context to confirm that the issue has been resolved and document the result in the Note.

​
Notes and External Ticketing Systems

The GermainUX Notes system can be used as the primary ticketing workflow for issues discovered through GermainUX. It can also complement external systems such as Jira, GitHub, Rally, or another enterprise ticketing platform. In that case, the GermainUX Note can preserve the detailed monitoring and analytical evidence while the external ticket supports the organization’s broader development or service-management process.

​
Get Help

Contact GermainUX Support

The Germain Team can help you set this up.

Can't find what you need?

Search all GermainUX docs with Ctrl + K, or use the feedback buttons at the bottom of this page to tell us what is missing.

The content of this document is proprietary to GERMAIN SOFTWARE LLC.