Skip to main content
Sumo Logic

Install the Apache Tomcat App and view the Dashboards

The Sumo Logic App for Apache Tomcat provides pre-configured Dashboards for Access, Catalina.out, and Garbage Collection logs.

Install the Sumo Logic App

Now that you have set up collection for Apache Tomcat, install the Sumo Logic App for Apache Tomcat to use the preconfigured searches and dashboards to analyze your data. 

To install the app:

  1. Select App Catalog, search for and select the app, and click Add to Library. (In the classic UI, click Library, click Apps, select the app, and click Install. If you don't find the app under Apps, it might be a preview app. Try clicking Preview to find the app.)
  2. Click Preview Dashboards if you'd like to see a preview of the dashboards included with the app before installing.
  3. In the Install Application dialog box, select the installation path (the default is the Personal folder in the library), or click New Folder to add a new folder.
  4. Select either of these options for the log data source.
  • Choose Select from Existing Source Categories, and select the source catalog from the Source Category list.
  • Choose Enter a Custom Data Filter and enter a custom source category beginning with an underscore. Example: (_sourceCategory=MyCategory).
  1. Click Add to Library.

Once an app is installed, it will appear in your Personal folder, or other folder that you specified. From here, you can share it with your organization. See Welcome to the New Library for information on working with the library in the new UI.

Panels will start to fill automatically. It's important to note that each Panel slowly fills with data matching the time range query and received since the Panel was created. Results won't immediately be available, but with a bit of time, you'll see full graphs and maps. 

Dashboards

Access

Tomcat - Overview

tomcat_app_overview_700x505.png

Visitor Locations. Uses a geo lookup operation to display visitor locations by IP address on a map of the world, which allows you to see a count of hits per location for the last hour.

Visitor Locations - 4xx Errors. Uses a geo lookup operation to display the location of visitors with 4xx errors by IP address on a map of the world, which allows you to see a count of hits per location for the last hour.

Non 200 Response Status Codes. Displays the number of non-200 response status codes in a bar chart for the last hour.

Top 10 - Traffic Distribution by Server. Shows the top 10 servers by traffic distribution in a bar chart for the last hour.

Media Types Served. Provides a list of file types being served in a pie chart for the last hour.

Responses. Displays a list of response types in a pie chart for the last hour.

Tomcat - Visitor Locations

tomcat_app_visitor_locations_700x348.png

Worldwide. Uses a geo lookup operation to display worldwide visitor locations by IP address on a map of the world, which allows you to see a count of hits per location for the last 24 hours.

Visits by Country Over Time. Displays the number of visitors by country in a stacked column chart on a timeline for the last hour.

United States. Uses a geo lookup operation to display US visitor locations by IP address on a map of the world, which allows you to see a count of hits per location for the last 24 hours.

Visits by US Sate Over Time. Displays the number of US visitors by state in a stacked column chart on a timeline for the last hour.

Tomcat - Visitor Traffic Insight

tomcat_app_visitor_traffic_insight_700x465.png

Traffic Volume and Bytes Served. Displays visitor traffic volume and bytes served in a combo chart on a timeline for the last 24 hours.

Responses Over Time. Shows the number of response types over time in a stacked column chart on a timeline for the last 24 hours.

Top Documents. Provides a list of the top 10 documents by URL being accessed by your visitors in a bar chart for the last hour.

Media Types Served. Displays a list of file types being served in a pie chart for the last hour.

Top Referrers. Shows a list of the top 10 referring websites by URL in a bar chart for the last hour.

Top 10 Search Terms from Popular Search Engines. Displays a list of the top 10 search terms and their count from search engines such as Google, Bing, and Yahoo in an aggregation table for the past hour.

Tomcat - Web Server Operations

tomcat_app_web_server_operations_700x319.png

Non 200 Response Status Codes. Displays the number of non-200 response status codes in a bar chart for the last hour.

Client Locations - 4xx Errors. Uses a geo lookup operation to display the location of clients with 4xx errors by IP address on a map of the world, which allows you to see a count of hits per location for the last hour.

Server Errors Over Time. Provides information on the type and number of server errors in a column chart on a timeline for the last hour.

Error Responses - Distribution by Server. Shows error responses and their distribution by server in a pie chart for the last hour.

Top 10 Clients Cause 4xx Errors. Displays a list of the top 10 clients that have 4xx errors in an aggregation table for the last hour.

Top 10 URIs Causing 404 Responses. Provides a list of the top 10 URIs with 404 response types in a bar chart for the last hour.

Tomcat Catalina Overview

tomcat_app_catalina_700x657.png

Log Levels. Displays log levels types (Info, Severe, and Warning) in a pie chart for the last 24 hours.

Non-INFO Errors. Shows the number and type of errors (Severe or Warning) in a stacked column chart on a timeline for the last 24 hours.

Component Errors. Provides information on errors by component in a pie chart for the last 24 hours.

Errors by Component. Displays Info level errors by component in a stacked column chart on a timeline for the last 24 hours.

Top 10 Recent Exceptions. Shows the top 10 most recent exceptions in an aggregation table with columns for time, log level, message, method, source file, and thrown for the last 24 hours.

Exceptions. Provides the number of exceptions in a column chart on a timeline for the last seven days.

Average Server Startup Time. Displays the average server startup time per second by day as a column chart on a timeline for the last seven days.

Server State Events Over Time. Shows server state events (shutdown or startup) in a stacked column chart on a timeline for the last seven days.

Garbage Collection Overview

tomcat_app_garbage_700x657.png

Top 10 Host - High GC Time. Displays the top 10 hosts with high garbage collection operation time as a bar chart for the last 12 hours.

Top 10 Hosts - Low Average JVM Up-Time. Shows the top 10 hosts by low average JVM up-time as a bar chart for the last 12 hours.

Total GC Operation Time. Provides the total garbage collection operation time by timeslices of 15 minutes in a column chart on a timeline for the last 12 hours.

Total GC Operations. Displays the total number of times Full-GC and Minor-GC collection processes are executed in timeslices of 15 minutes on in a stacked column chart on a timeline for the past 12 hours.

Heap. Shows the total heap memory utilization just before garbage collection was executed vs. total heap memory utilization after garbage collection was executed, in a line chart on a timeline for the last 12 hours.

PS Young Gen. PS Young Gen also refers to “New Space,” which is comprised of of Eden-Space and two Survivor-Spaces of identical size, usually called From and To. This panel shows Young Gen memory utilization just before garbage collection was executed vs. Young Gen memory utilization after garbage collection was executed. This part of the heap always gets garbage collected.

Par Old Gen. Par Old Gen is also referred as “Tenured Space”. This panel shows Old Gen memory utilization just before garbage collection was executed vs. Old Gen memory utilization after garbage collection was executed.

PS Perm Gen. PS Perm Gen is also referred as “Permanent Space”. This panel shows Perm Gen memory utilization just before garbage collection was executed vs. Perm Gen memory utilization after garbage collection was executed.