Log View Widget

Overview

Log View is a widget that presents your log data in a format similar to Common Log Format. In other terms, it has the look and feel of a console output. In addition, the Log View widget allows you to scroll through log events as it populates new lines in real-time.

Of course, the Log View widget will provide you a way to investigate your log events, to accomplish such actions as:

  • recording faults to diagnose and debug

  • identifying security breaches and other system and network misuses.

  • auditing

When you build aggregations in the Log View widget expect it to help you create highly customizable reports and infographics. Furthermore, you can add them to your dashboards. Also, you can save and retrieve them, in the event you need to review that data again. At any time, you can add new values, fields, and metrics to build reports that you need.

Note

According to the section Export results as CSV, Graylog Open Source is limited to exports in CSV. However, three additional formats are available in Enterprise: JSON, Newline delimited JSON, and Plain Text form.

Log View Usage

To get familiar with Log View, perform the following actions.

  • Create a new Log View widget.

  • Expand your report with additional fields, in the widget.

  • Focus on the widget with an expanded view.

  • Export data from your widget.

Create a Log View Widget

The Log View Widget is located on the expandable bar, screen left.

../../_images/log_view_left_menu.png

To create your first widget:

  1. Click the Create (+) button to extend the menu.

  2. Select Log View to generate the widget in the main UI.

../../_images/log_view_default.png

When the button generates a new widget, timestamp, source, and message are the default fields presented in plain text format.

Add New Fields to the Report

To build more informed reports, you might add a new field to the widget. For example, you may need to associate activity between company.org and an http response code.

../../_images/log_view_expand_arrow.png
  1. Click the diagonal arrow icon on right side of a logline.

  2. Review and select one or more options, e.g. http_response_code.

../../_images/log_view_select_fields.png

Alternately, you can add new fields via the chevron icon (mentioned in “Aggregation”).

  1. Click Edit from the menu.

  2. Locate FIELD SELECTION AND ORDER on the bottom left.

  3. Click the dropdown arrow, or type in a value.

  4. Click Add to include the field in your widget.

  5. Press the Apply Changes button to save all your edits.

../../_images/log_view_field_selection_alternate.png

Focus on the Widget

When you return to the main Log View UI, identify the x-crossed arrow icon next to the other widget icons.

../../_images/log_view_widget_focus_icon_cu.png

Click the icon to expand your widget to full view:

../../_images/log_view_widget_focus_UI.png

Build a Dashboard with Shareable Data

In this section, you will determine a format that best suits your message delivery efforts, and download a report. For example, you might pass on:

  • plain text data to your peers for analysis (i.e. Log File/Plain Text)

  • data to a logging library built in JavaScript (i.e. JSON)

  • structured data objects to TCP or UNIX pipes (i.e. NDJSON)

If still configured, you may use the dashboard created in Create a Log View Widget.

../../_images/log_view_export_chevron.png

Follow the steps

  1. Click the chevron icon to access the Actions menu. (The icon is circled red in the image above.)

  2. Choose Export from the menu to access the dialog.

    • Output Format — choose from JSON, Log File/Plain Text, NDJSON (Newline-delimited JSON), or CSV.

    • Fields to export — add additional fields to the pre-defined options chosen in Add New Fields to the Report.

    • Time Range — Click the clock icon to configure an Absolute date range. The format is displayed in yyyy-MMM-dd HH:mm:ss.SSS.

  3. Click the Start Download button after choosing all necessary fields and optional Messages limit.