Basic Configuration of the Monitor Extension

Many aspects of the monitor extension are configurable. All configuration files are stored in the data directory under the monitoring directory:

<data_directory>
    monitoring/
        filter.properties
        monitor.properties

The function of these files will be discussed below.

Monitor Mode

The monitoring extension supports different “monitoring modes” that control how request data is captured and stored. Currently three modes are supported:

  • history (Default) - Only historical request information is available. No live information is maintained.

  • live - Only information about live requests is maintained.

The mode is set in the monitor.properties file.

Note

For the Virtual Machine GeoServer instance, we are “live” mode.

History Mode

History mode persists information about all requests in an external database. It does not provide any real time information. This mode is appropriate in cases where a user is most interested in analyzing request history over a given time period.

Live Mode

Live mode only maintains short lived information about requests that are currently executing. It also maintains a small buffer of recent requests. No external database is used with this mode and no information is persisted for the long term.

This mode is most appropriate in cases where a user only cares about what a server is doing in real time and is not interested about request history.

Request Filters

By default not all requests are monitored. Those excluded requests include any web admin requests or any monitor HTTP API requests. These exclusions are configured in the filter.properties file:

/rest/monitor/**
/web
/web/**
/pdf/**

These default filters can be changed or extended to filter more types of requests. For example to filter out all WFS requests:

/wfs

How to determine the filter path

The contents of filter.properties are a series of ant-style patterns that are applied to the path of the request. Consider the following request:

http://localhost:8083/geoserver/wms?request=getcapabilities

The path of the above request is /wms.

In the following request:

http://localhost:8083/geoserver/rest/workspaces/topp/datastores.xml

The path is /rest/workspaces/topp/datastores.xml.

In general, the path used in filters is comprised of the portion of the URL after /geoserver (including the preceding /) and before the query string ?:

http://<host>:<port>/geoserver/<path>?<queryString>

Note

For more information about ant-style pattern matching, see the Apache Ant manual.

  1. Go to the Map Map Preview and open the geosolutions:Counties layer clicking on the OpenLayer link.

  2. Perform a few times zoom the map.

  3. Use also the GML preview for said layer

  4. Navigate to the Monitor/Reports section

  5. Click on OWS Request Summary to show a detailed chart like the following:

    ../_images/monitor1.png