Oracle Cloud Infrastructure Documentation

Create a Label

Oracle Log Analytics will automatically apply labels to your log entries as they are ingested based on the various label definitions in your source. For example, in the Oracle-defined source Database Alert Logs, the labels are already defined for the most common ORA-xxxx error codes. When analyzing your logs, you can search by label or by the actual ORA-xxxx error code. Oracle Log Analytics offers multiple Oracle-defined labels that you can use with Oracle-defined sources or in your custom sources. You can use the Create Label page to create new labels that can be used in your custom sources.

  1. Open the navigation menu and click Observability & Management. Under Log Analytics, click Administration. The Administration Overview page opens.

    The administration resources are listed in the left hand navigation pane under Resources. Click Labels.

  2. In the Labels page, click Create Label.
  3. In the Label field, enter the label name. For example, enter Gateway Timeout.
  4. In the Description field, enter the details about the label.
  5. Labels can be marked as being a problem with a priority to make those log entries more prominent in the Log Explorer. To assign priority to the label:

    1. Under Denotes Problem field, select Yes check box.

    2. In the Problem Priority field, click the down arrow and select a priority. For example, select High.

    A log entry will be assigned a problem priority based on the labels that get attached to the log entry. In this case, if Gateway Timeout label has a problem priority of High, any log entry that matches a condition such that it gets the Gateway Timeout label would have a problem priority of High.

  6. In the Related Terms field, enter the terms that are related to the log entry.
  7. Click Save.
You can now use the new custom label in your log source to enrich a log entry. See Use Labels in Sources.
After the custom labels are created, you can use them in the label definitions in the log sources, and you can search the log data based on the labels that you’ve created. See Filter Logs by Labels. The labels can be used for search as in the following example use-cases:

  • To obtain rapid summary of all error trends:

    In the Log Explorer, click the field Labels in the Fields section. In the Labels dialog box, enable the Show Trend Chart check box.


    Label dialog box

  • To identify the problem events:

    In the Log Explorer, drag the field Labels in the Fields section to the Group By section in the visualization panel.


    problem logs where the problem priority has been set while creating a label

  • To search across sources using the query language:


    a field summary consisting of log records that have the specified label

  • To perform analysis using query language in combination with clusters:


    the cluster visualization in combination with label specified in the query

    View the log data within the cluster for classify results:


    Description of labels-language-analysis3.png follows
    Description of the illustration labels-language-analysis3.png