﻿---
title: Categorize log entries
description: Application log events are often unstructured and contain variable data. Many log messages are the same or very similar, so classifying them can reduce...
url: https://www.elastic.co/elastic/docs-builder/docs/2423/solutions/observability/logs/categorize-log-entries
products:
  - Elastic Observability
---

# Categorize log entries
Application log events are often unstructured and contain variable data. Many log messages are the same or very similar, so classifying them can reduce millions of log lines into just a few categories.
The **Categories** page enables you to identify patterns in your log events quickly. Instead of manually identifying similar logs, the logs categorization view lists log events that have been grouped based on their messages and formats so that you can take action quicker.
<note>
  This feature makes use of machine learning anomaly detection jobs. To set up jobs, you must have `all` Kibana feature privileges for **Machine Learning**. Users that have full or read-only access to machine learning features within a Kibana space can view the results of *all* anomaly detection jobs that are visible in that space, even if they do not have access to the source indices of those jobs. You must carefully consider who is given access to machine learning features; anomaly detection job results may propagate field values that contain sensitive information from the source indices to the results. For more details, refer to [Set up machine learning features](https://www.elastic.co/elastic/docs-builder/docs/2423/explore-analyze/machine-learning/setting-up-machine-learning).
</note>


## Create log categories

Create a machine learning job to categorize log messages automatically. Machine learning observes the static parts of the message, clusters similar messages, classifies them into message categories, and detects unusually high message counts in the categories.
1. Open the **Categories** page by finding `Logs / Categories` in the [global search field](https://www.elastic.co/elastic/docs-builder/docs/2423/explore-analyze/find-and-organize/find-apps-and-objects). You are prompted to use machine learning to create log rate categorizations.
2. Choose a time range for the machine learning analysis. By default, the machine learning job analyzes log messages no older than four weeks and continues indefinitely.
3. Add the indices that contain the logs you want to examine. By default, Machine Learning analyzes messages in all log indices that match the patterns set in the **logs sources** advanced setting. To open **Advanced settings**, find it in the navigation menu or by using the [global search field](https://www.elastic.co/elastic/docs-builder/docs/2423/explore-analyze/find-and-organize/find-apps-and-objects).
4. Click **Create ML job**. This creates and runs the job. It takes a few minutes for the machine learning robots to collect the necessary data. After the job has processed the data, you can view its results.

<note applies-to="stack: ga 9.2">
  Log categorization machine learning jobs retain results for 120 days by default. Modify the `results_retention_days` setting to change this period.
</note>


## Analyze log categories

The **Categories** page lists all the log categories from the selected indices. You can filter the categories by indices. The screenshot below shows the categories from the `elastic.agent` log.
![Log categories](https://www.elastic.co/elastic/docs-builder/docs/2423/solutions/images/observability-log-categories.jpg)

The category row contains the following information:
- message count: shows how many messages belong to the given category.
- trend: indicates how the occurrence of the messages changes in time.
- category name: it is the name of the category and is derived from the message text.
- datasets: the name of the datasets where the categories are present.
- maximum anomaly score: the highest anomaly score in the category.

To view a log message for a particular category, click the arrow at the end of the row. To further examine it, click **View in Discover** or **View in context**
![Opened log category](https://www.elastic.co/elastic/docs-builder/docs/2423/solutions/images/observability-log-opened.png)

For more information about categorization, go to [Detecting anomalous categories of data](https://www.elastic.co/elastic/docs-builder/docs/2423/explore-analyze/machine-learning/anomaly-detection/ml-configuring-categories).