> ## Documentation Index
> Fetch the complete documentation index at: https://docs.germainux.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Categorization

> Germain categorizes data and events into meaningful groups, making it easier to spot new issues in large volumes of occurrences.

Service
`Analytics`

Availability
2015.1 or later

> **[In summary](#in-summary)**
>
> Faster troubleshooting outcomes

> **[AI-Generated Labels for Scripted Categorization](#ai-generated-labels-for-scripted-categorization)**
>
> AI labels for high volume

> **[AI-Driven Fact Categorization](#ai-driven-fact-categorization)**
>
> LLM categorization for low volume

> **[Examples](#examples)**
>
> Sample categorization scenarios

## Overview

Germain categorizes data and events into meaningful groups, making it easier to spot new issues in large volumes of occurrences. This is useful for detecting previously unseen code exceptions or application crashes, especially when they span multiple data sources (for example, binary and text files).

System administrators can quickly identify crashes or exceptions that haven’t occurred before and focus on issues that need immediate attention. This proactive approach reduces impact on system performance and user experience.

## In summary

**In summary**, Germain’s categorization features significantly enhance error management by helping system administrators:

| | Capability |
| - | - |
| 1 | Analyze the frequency of errors |
| 2 | Reduce the effort required to review issues |
| 3 | Prioritize the resolution of critical problems |
| 4 | Detect new or unique errors automatically |

These capabilities streamline the troubleshooting process, leading to faster resolution and improved overall system stability.

> [!NOTE]
>
> **Video Overview:**[https://youtu.be/NaQ\_IQRjbU4](https://youtu.be/NaQ_IQRjbU4)

## AI-Generated Labels for Scripted Categorization

GermainUX now supports AI-generated labels for data categorization when **High-Volume data** Categorization is required e.g. JavaScript console events. Data is categorized through custom scripts (existing categorization mechanism) that are performant at scale. **New labels** for these categories can be **AI-generated** to make them **human-readable**, improving clarity and reducing manual effort.

## AI-Driven Fact Categorization

GermainUX’s fact categorization also supports categorization utilizing one of several LLMs (Large Language Model) most used when **Low-Volume Data**is involved e.g. User Feedback. GermainUX’s **AI service handles the entire categorization process**. It uses a **customizable prompt** to classify and update each fact accordingly.

## Examples

### Java Exception Categorization

For Java applications, Germain analyzes the full "path" of an exception or failure to differentiate between new and recurring issues. While most APMs simply log another `NullPointerException`, Germain distinguishes between instances such as:

| Example | Code Path |
| - | - |
| UserService.getCurrent | `UserService.getCurrent` |
| BusinessLogicService.performLogic | `BusinessLogicService.performLogic` |

This granularity is essential for managing errors effectively, especially at scale.

Examples: **Java Exception**detected by GermainUX:

![Detection of Java Exception](https://mintcdn.com/germain-ux/npHkPTFCfiH3hzwe/images/main/data-categorization/Java-Error-1.png?fit=max\&auto=format\&n=npHkPTFCfiH3hzwe\&q=85\&s=4282096f4c9e27c41a17d8368ed014c1)

Detection of Java Exception - GermainUX

### Javascript Error Categorization

For web applications built with frameworks like Angular, React, etc., Germain identifies new error types and evaluates their business impact. Unlike most APMs that just report another generic `Uncaught TypeError`, Germain differentiates between issues like:

| Example Snippet | Code |
| - | - |
| Reading method error | `...reading ‘toString’...` |
| Property access error | `...reading 'b'...` |

This precision helps teams locate and resolve problems more effectively.

### Examples: **JavaScript Error**detected by GermainUX

![Detection of Javascript Error](https://mintcdn.com/germain-ux/npHkPTFCfiH3hzwe/images/main/data-categorization/Javascript-Error-2.png?fit=max\&auto=format\&n=npHkPTFCfiH3hzwe\&q=85\&s=b05e8ec5c79efaaa795969783501abb0)

Detection of Javascript Error - GermainUX

### Siebel CRM Object Manager Crash Categorization

For Siebel CRM, analyzing an Object Manager (OM) crash may require parsing several files, including:

| File Type | Details |
| - | - |
| Enterprise logs | Enterprise logs |
| Object Manager logs | Object Manager logs |
| FDR files | FDR files |
| Core dump files | Core dump files |

Germain streamlines this process by categorizing hundreds of OM crash events into digestible, actionable insights.

### Example

A portlet showcasing categorization results for hundreds of Siebel OM crashes.

![Siebel Crash Categorized](https://mintcdn.com/germain-ux/npHkPTFCfiH3hzwe/images/main/data-categorization/image-20211223-103427.png?fit=max\&auto=format\&n=npHkPTFCfiH3hzwe\&q=85\&s=90a056aa235598f24f31f8dc49715e05)

Siebel Crash Categorized - GermainUX

![Siebel Crash Trend](https://mintcdn.com/germain-ux/npHkPTFCfiH3hzwe/images/main/data-categorization/image-20211223-103622.png?fit=max\&auto=format\&n=npHkPTFCfiH3hzwe\&q=85\&s=b828238d030df0a0b50196aa0f9307a5)

Siebel Crash Trend - GermainUX

## Additional Resources

> **[AI](https://docs.germainux.com/main/ai-driven-insights.md)**
>
> Insights & Recommendations

> **[Outliers And Anomaly Detection](https://docs.germainux.com/main/outlier-detection.md)**
>
> Read more

> **[Analytics](https://docs.germainux.com/main/analytics.md)**
>
> More Analytics Features

> **[Automation](https://docs.germainux.com/main/automation.md)**
>
> More Automation Features

> **[Dashboards](https://docs.germainux.com/main/dashboard-and-report.md)**
>
> Dashboards and reports overview

> **[Reports](https://docs.germainux.com/main/reporting-automatic.md)**
>
> Automatic and scheduled reports

> **[Management](https://docs.germainux.com/main/management.md)**
>
> More Management Features

## Get Help

> **[Contact GermainUX Support](https://docs.germainux.com/main/support.md)**
>
> 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.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.