Logstail
Skip to Content

Visualizations

The Visualizations page is used to create and view visual components that can be used in dashboards and analytics workflows. Visualizations transform raw event data into charts, graphs, counters, tables, and other visual formats that help users understand patterns quickly.

Where to find it

Visualizations

Open the Visualizations page to create and manage visual panels for dashboards.

Sidebar path

Analytics
Visualizations

Route path

/visualizations

What this page is used for

Use Visualizations to:

Build charts

Create visualizations from indexed data.

Use saved searches

Turn searches into visual panels.

Create reusable components

Build visual elements for dashboards.

Support dashboards & reports

Feed visualizations into analytics workflows.

Highlight trends

Show counts, distributions, and relationships.

Support SOC workflows

Build focused views for investigations.

Main View

Visualizations open in a full-page embedded visualization builder or viewer.

visualizations

Visualization Types

Available visualization types include: For each visualization, there is a description showing when hovering.

Area
Controls
Coordinate Map
Data Table
Gantt Chart
Gauge
Goal
Heat Map
Horizontal Bar
Line
Maps
Markdown
Metric
PPL
Pie
Region Map
TSVB
Tag Cloud
Timeline
Vega
Vertical Bar
VisBuilder

Creating a Visualization

A typical visualization workflow is:

new-visualization

visualizations-index-pattern

visualizations-saved-search

What Fields Mean

In the visualization creation process, fields are the individual data attributes stored inside indexed events.

A field is a specific value collected from logs, metrics, alerts, endpoint events, network data, or other telemetry sources. Fields tell the visualization what data to use.

Fields are used to decide what the visualization should count, group, split, filter, or display.

For example:

Bar chart

Group events by agent.name to visualize activity across endpoints.

Line chart

Use @timestamp to show event volume and trends over time.

Pie chart

Split alerts by rule.severity to understand distribution across severity levels.

Data table

Display multiple fields such as host.name, user.name, and event.action for detailed analysis.

Metric counter

Count all records that match the selected query to highlight totals or key indicators.

Examples of Fields Users May Select

The available fields depend on the selected index pattern, saved search, and collected data.

FieldDescription
@timestampEvent time used for time-based charts
agent.nameName of the endpoint agent
agent.ipIP address of the endpoint agent
host.nameHostname of the system
user.nameUser associated with the event
event.actionAction recorded by the event
event.categoryEvent category such as process, network, authentication, or file
event.datasetDataset or log source
log.levelLog level such as info, warning, error, or critical
process.nameProcess name
process.executableFull executable path
process.parent.executableParent process executable path
source.ipSource IP address
destination.ipDestination IP address
network.protocolNetwork protocol
rule.nameDetection or rule name
rule.severityDetection or alert severity
service.nameService name
winlog.channelWindows Event Log channel
winlog.event_idWindows Event ID

Choosing the Right Data Source

For SIEM use cases, select the relevant SIEM index pattern, commonly: logstail-siem-*

Use a saved search when the visualization should always include a specific query or filter set.

Saving Visualizations

When saving a visualization, use a name that clearly describes:

The data source
The metric or event type
The use case
The target team or dashboard, if applicable

Good naming makes it easier to manage saved objects later.

Examples of clear names:

SIEM - Alert Volume Over Time
SIEM - Authentication Failures by User
Endpoint Activity by Host
Process Execution by Path
Network Activity by Protocol

Operational Examples

Alert Volume Over Time

Create a time-series visualization that shows detection or alert counts over a selected time window.

Recommended configuration:

Visualization type — Line or TSVB
Index pattern — logstail-siem-*
Time field — @timestamp
Metric — Count of records
Optional field — rule.name
Optional field — rule.severity
Optional field — event.category

Authentication Failures by User

Create a bar chart showing failed authentication events grouped by user.

Recommended configuration:

Visualization type — Vertical Bar or Horizontal Bar
Index pattern — logstail-siem-*
Field — user.name
Filter — Authentication failure events
Metric — Count of records

Endpoint Activity by Host

Create a table or chart that groups events by agent.name.

Recommended configuration:

Visualization type — Vertical Bar, Horizontal Bar, or Data Table
Index pattern — logstail-siem-*
Field — agent.name or host.name
Metric — Count of records

Create a visualization that tracks process creation events by executable path or parent process.

Recommended configuration:

Visualization type — Data Table, Vertical Bar, Horizontal Bar, or Line
Index pattern — logstail-siem-*
Field — process.name
Field — process.executable
Field — process.parent.executable
Field — user.name
Field — agent.name
Field — @timestamp

Network Activity by Protocol

Create a chart that compares network activity by protocol.

Recommended configuration:

Visualization type — Pie, Vertical Bar, Horizontal Bar, or Data Table
Index pattern — logstail-siem-*
Primary field — network.protocol
Metric — Count of records
Optional field — source.ip
Optional field — destination.ip

Troubleshooting

Visualization shows no data

  1. 1

    Check the index pattern, time range, query filters, and field selection.

Field is missing

  1. 1

    Confirm that the field exists in Discover for the selected index pattern.

  2. 2

    If the field exists in raw events but does not appear in the visualization builder, refresh the index pattern or check whether the field is available for aggregation.

Chart does not update

  1. 1

    Refresh the visualization or adjust the time range.

Visualization cannot be added to a dashboard

  1. 1

    Confirm the visualization was saved successfully.

  2. 2

    Confirm that the dashboard supports adding saved panels.

Results look incorrect

  1. 1

    Review the selected metric, bucket, field, filter, and time range.

  2. 2

    If grouping by host, confirm that the visualization uses agent.name or host.name instead of a unique event field.

Best Practices

Start from validated data

Build visualizations from validated Discover queries.

Keep visualizations focused

Use focused visualizations with a clear operational purpose.

Choose the right fields

Choose fields based on the question the visualization should answer.

Use time fields

Use @timestamp for time-based visualizations.

Group by category

Use fields such as agent.name, host.name, user.name, rule.severity, or network.protocol for grouped charts.

Limit categories

Avoid charts with too many categories.

Use consistent naming

Save visualizations with consistent naming.

Review after changes

Recheck visualizations after field or index changes.

Back up content

Use saved objects to back up important visualization content.