---
title: "Connect Geneos to Obcerv"
description: ""
url: "https://docs.itrsgroup.com/docs/geneos/current/processing/data-access-and-publishing/connect_geneos_to_obcerv/index.html"
---
## Overview

Obcerv is an observability platform for data storage and analytics. You can configure Gateways and Netprobes to publish data to Obcerv so you can store and analyse metrics, logs and events in Obcerv.

## Obcerv concepts

Obcerv adopts a data model that includes many features that may sound familiar to Geneos users. However, it is important to recognise that these concepts are fundamentally different.

### Entities

Unlike the user-defined Managed Entities in Geneos, in Obcerv an Entity is automatically created based on the dimensions that describe the data points. See the [Data model](https://docs.itrsgroup.com/docs/itrs-analytics/platform/current/getting-started/architecture/#data-model) for more information.

Entities can also have associated attributes but this does not affect the definition of an Entity. Obcerv allows users to search for Entities metrics using both dimensions and attributes.

Geneos structures are mapped to Obcerv entities, attributes, and metrics.

Consider an example:

<div class="table-container">
<table class="legacy-table" style="margin-left: 0;margin-right: auto;width: 100%;mc-table-style: url('../../Resources/TableStyles/ref_2_col_table.css');" class="TableStyle-ref_2_col_table" cellspacing="0">
                <col class="TableStyle-ref_2_col_table-Column-Column1"/>
                <col class="TableStyle-ref_2_col_table-Column-Column1"/>
                <col class="TableStyle-ref_2_col_table-Column-Column1"/>
                <col class="TableStyle-ref_2_col_table-Column-Column1"/>
                <thead>
                    <tr class="TableStyle-ref_2_col_table-Head-Header1">
                        <th class="TableStyle-ref_2_col_table-HeadE-Column1-Header1"><MadCap:variable name="General.ProductNameGeneos"/> item</th>
                        <th class="TableStyle-ref_2_col_table-HeadE-Column1-Header1">Entity dimensions</th>
                        <th class="TableStyle-ref_2_col_table-HeadE-Column1-Header1">Attributes</th>
                        <th class="TableStyle-ref_2_col_table-HeadD-Column1-Header1">Metrics</th>
                    </tr>
                </thead>
                <tbody>
                    <tr class="TableStyle-ref_2_col_table-Body-Body1">
                        <td class="TableStyle-ref_2_col_table-BodyE-Column1-Body1">Managed Entity	</td>
                        <td class="TableStyle-ref_2_col_table-BodyE-Column1-Body1">probe=itrspc101	</td>
                        <td class="TableStyle-ref_2_col_table-BodyE-Column1-Body1">ConState=Up</td>
                        <td class="TableStyle-ref_2_col_table-BodyD-Column1-Body1"> </td>
                    </tr>
                    <tr class="TableStyle-ref_2_col_table-Body-Body1">
                        <td class="TableStyle-ref_2_col_table-BodyE-Column1-Body1">Managed Entity	</td>
                        <td class="TableStyle-ref_2_col_table-BodyE-Column1-Body1">managedEntity=pc101</td>
                        <td class="TableStyle-ref_2_col_table-BodyE-Column1-Body1">HostName=itrspc101.itsgroup.com</td>
                        <td class="TableStyle-ref_2_col_table-BodyD-Column1-Body1"> </td>
                    </tr>
                    <tr class="TableStyle-ref_2_col_table-Body-Body1">
                        <td class="TableStyle-ref_2_col_table-BodyE-Column1-Body1">Managed Entity	</td>
                        <td class="TableStyle-ref_2_col_table-BodyE-Column1-Body1"> </td>
                        <td class="TableStyle-ref_2_col_table-BodyE-Column1-Body1">COUNTRY=UK</td>
                        <td class="TableStyle-ref_2_col_table-BodyD-Column1-Body1"> </td>
                    </tr>
                    <tr class="TableStyle-ref_2_col_table-Body-Body1">
                        <td class="TableStyle-ref_2_col_table-BodyE-Column1-Body1">Managed Entity	</td>
                        <td class="TableStyle-ref_2_col_table-BodyE-Column1-Body1"> </td>
                        <td class="TableStyle-ref_2_col_table-BodyE-Column1-Body1">OS=Linux</td>
                        <td class="TableStyle-ref_2_col_table-BodyD-Column1-Body1"> </td>
                    </tr>
                    <tr class="TableStyle-ref_2_col_table-Body-Body1">
                        <td class="TableStyle-ref_2_col_table-BodyE-Column1-Body1">Managed Entity	</td>
                        <td class="TableStyle-ref_2_col_table-BodyE-Column1-Body1"> </td>
                        <td class="TableStyle-ref_2_col_table-BodyE-Column1-Body1">DEPT=SALES</td>
                        <td class="TableStyle-ref_2_col_table-BodyD-Column1-Body1"> </td>
                    </tr>
                    <tr class="TableStyle-ref_2_col_table-Body-Body1">
                        <td class="TableStyle-ref_2_col_table-BodyE-Column1-Body1">Sampler</td>
                        <td class="TableStyle-ref_2_col_table-BodyE-Column1-Body1">probe=itrspc101</td>
                        <td class="TableStyle-ref_2_col_table-BodyE-Column1-Body1">Plugin Name=CPU</td>
                        <td class="TableStyle-ref_2_col_table-BodyD-Column1-Body1"> </td>
                    </tr>
                    <tr class="TableStyle-ref_2_col_table-Body-Body1">
                        <td class="TableStyle-ref_2_col_table-BodyE-Column1-Body1">Sampler</td>
                        <td class="TableStyle-ref_2_col_table-BodyE-Column1-Body1">managedEntity=pc101</td>
                        <td class="TableStyle-ref_2_col_table-BodyE-Column1-Body1">Group Name=Infra</td>
                        <td class="TableStyle-ref_2_col_table-BodyD-Column1-Body1"> </td>
                    </tr>
                    <tr class="TableStyle-ref_2_col_table-Body-Body1">
                        <td class="TableStyle-ref_2_col_table-BodyE-Column1-Body1">Sampler</td>
                        <td class="TableStyle-ref_2_col_table-BodyE-Column1-Body1">sampler=CPU</td>
                        <td class="TableStyle-ref_2_col_table-BodyE-Column1-Body1"> </td>
                        <td class="TableStyle-ref_2_col_table-BodyD-Column1-Body1"> </td>
                    </tr>
                    <tr class="TableStyle-ref_2_col_table-Body-Body1">
                        <td class="TableStyle-ref_2_col_table-BodyE-Column1-Body1">Sampler</td>
                        <td class="TableStyle-ref_2_col_table-BodyE-Column1-Body1">type=LinuxInfra</td>
                        <td class="TableStyle-ref_2_col_table-BodyE-Column1-Body1"> </td>
                        <td class="TableStyle-ref_2_col_table-BodyD-Column1-Body1"> </td>
                    </tr>
                    <tr class="TableStyle-ref_2_col_table-Body-Body1">
                        <td class="TableStyle-ref_2_col_table-BodyE-Column1-Body1">Dataview</td>
                        <td class="TableStyle-ref_2_col_table-BodyE-Column1-Body1">probe=itrspc101	</td>
                        <td class="TableStyle-ref_2_col_table-BodyE-Column1-Body1"> </td>
                        <td class="TableStyle-ref_2_col_table-BodyD-Column1-Body1">numCpuCores</td>
                    </tr>
                    <tr class="TableStyle-ref_2_col_table-Body-Body1">
                        <td class="TableStyle-ref_2_col_table-BodyE-Column1-Body1">Dataview</td>
                        <td class="TableStyle-ref_2_col_table-BodyE-Column1-Body1">managedEntity=pc101</td>
                        <td class="TableStyle-ref_2_col_table-BodyE-Column1-Body1"> </td>
                        <td class="TableStyle-ref_2_col_table-BodyD-Column1-Body1">numOnlineCpus</td>
                    </tr>
                    <tr class="TableStyle-ref_2_col_table-Body-Body1">
                        <td class="TableStyle-ref_2_col_table-BodyE-Column1-Body1">Dataview</td>
                        <td class="TableStyle-ref_2_col_table-BodyE-Column1-Body1">sampler=CPU	</td>
                        <td class="TableStyle-ref_2_col_table-BodyE-Column1-Body1"> </td>
                        <td class="TableStyle-ref_2_col_table-BodyD-Column1-Body1">loadAverage1Min</td>
                    </tr>
                    <tr class="TableStyle-ref_2_col_table-Body-Body1">
                        <td class="TableStyle-ref_2_col_table-BodyE-Column1-Body1">Dataview</td>
                        <td class="TableStyle-ref_2_col_table-BodyE-Column1-Body1">type=LinuxInfra</td>
                        <td class="TableStyle-ref_2_col_table-BodyE-Column1-Body1"> </td>
                        <td class="TableStyle-ref_2_col_table-BodyD-Column1-Body1">loadAverage5Min</td>
                    </tr>
                    <tr class="TableStyle-ref_2_col_table-Body-Body1">
                        <td class="TableStyle-ref_2_col_table-BodyE-Column1-Body1">Dataview</td>
                        <td class="TableStyle-ref_2_col_table-BodyE-Column1-Body1">dataview=CPU	</td>
                        <td class="TableStyle-ref_2_col_table-BodyE-Column1-Body1"> </td>
                        <td class="TableStyle-ref_2_col_table-BodyD-Column1-Body1"> </td>
                    </tr>
                    <tr class="TableStyle-ref_2_col_table-Body-Body1">
                        <td class="TableStyle-ref_2_col_table-BodyE-Column1-Body1">Row</td>
                        <td class="TableStyle-ref_2_col_table-BodyE-Column1-Body1">probe=itrspc101		</td>
                        <td class="TableStyle-ref_2_col_table-BodyE-Column1-Body1"> </td>
                        <td class="TableStyle-ref_2_col_table-BodyD-Column1-Body1">type</td>
                    </tr>
                    <tr class="TableStyle-ref_2_col_table-Body-Body1">
                        <td class="TableStyle-ref_2_col_table-BodyE-Column1-Body1">Row</td>
                        <td class="TableStyle-ref_2_col_table-BodyE-Column1-Body1">managedEntity=pc101	</td>
                        <td class="TableStyle-ref_2_col_table-BodyE-Column1-Body1"> </td>
                        <td class="TableStyle-ref_2_col_table-BodyD-Column1-Body1">clockSpeed</td>
                    </tr>
                    <tr class="TableStyle-ref_2_col_table-Body-Body1">
                        <td class="TableStyle-ref_2_col_table-BodyE-Column1-Body1">Row</td>
                        <td class="TableStyle-ref_2_col_table-BodyE-Column1-Body1">sampler=CPU	</td>
                        <td class="TableStyle-ref_2_col_table-BodyE-Column1-Body1"> </td>
                        <td class="TableStyle-ref_2_col_table-BodyD-Column1-Body1">percentUtilisation</td>
                    </tr>
                    <tr class="TableStyle-ref_2_col_table-Body-Body1">
                        <td class="TableStyle-ref_2_col_table-BodyE-Column1-Body1">Row</td>
                        <td class="TableStyle-ref_2_col_table-BodyE-Column1-Body1">type=LinuxInfra	</td>
                        <td class="TableStyle-ref_2_col_table-BodyE-Column1-Body1"> </td>
                        <td class="TableStyle-ref_2_col_table-BodyD-Column1-Body1">percentUserTime</td>
                    </tr>
                    <tr class="TableStyle-ref_2_col_table-Body-Body1">
                        <td class="TableStyle-ref_2_col_table-BodyE-Column1-Body1">Row</td>
                        <td class="TableStyle-ref_2_col_table-BodyE-Column1-Body1">dataview=CPU	</td>
                        <td class="TableStyle-ref_2_col_table-BodyE-Column1-Body1"> </td>
                        <td class="TableStyle-ref_2_col_table-BodyD-Column1-Body1">percentIdle</td>
                    </tr>
                    <tr class="TableStyle-ref_2_col_table-Body-Body1">
                        <td class="TableStyle-ref_2_col_table-BodyE-Column1-Body1">Row</td>
                        <td class="TableStyle-ref_2_col_table-BodyE-Column1-Body1">row=cpu_0</td>
                        <td class="TableStyle-ref_2_col_table-BodyE-Column1-Body1"> </td>
                        <td class="TableStyle-ref_2_col_table-BodyD-Column1-Body1"> </td>
                    </tr>
                    <tr class="TableStyle-ref_2_col_table-Body-Body1">
                        <td class="TableStyle-ref_2_col_table-BodyB-Column1-Body1"> </td>
                        <td class="TableStyle-ref_2_col_table-BodyB-Column1-Body1"> </td>
                        <td class="TableStyle-ref_2_col_table-BodyB-Column1-Body1"> </td>
                        <td class="TableStyle-ref_2_col_table-BodyA-Column1-Body1"> </td>
                    </tr>
                </tbody>
            </table>
            
</div>

In general, traditional  data generates the following  entities:

- An entity to represent each Geneos Managed Entity.
- An entity to represent each Geneos sampler.
- An entity to represent each dataview (where headline metrics exist).
- An entity to represent each row in a dataview (or column if the dataview is pivoted).

Cells in dataview rows (and headlines) are mapped to metrics that exist on these Obcerv entities according to the following rules:

- If the cell is marked as having a numeric data type in its schema then its contents will be published to Obcerv as a `GAUGE` metric.
- If the cell is marked as having a non-numeric data type in its schema then its contents will be published to Obcerv as a `STATUS_METRIC`.
- If no schema has been defined, the Gateway will attempt to convert the cell to a `GAUGE` metric. If this succeeds the value will be published as a `GAUGE`, otherwise, it will be published as a `STATUS_METRIC`.

For data that is sent to Geneos by a Collection Agent, the type of the metric will be preserved. As Collection Agent v2 does not use `STATUS_METRIC`, non-numeric data from Collection Agent will be sent and published as `ATTRIBUTES`.

Obcerv closely follows the data model used by the Collection Agent. For more information, see [Data collection in an orchestrated environment](https://docs.itrsgroup.com/docs/geneos/current/collection/data-collection-in-orchestrated-environments/data-collection-in-orchestrated-env/index.html).

### Data labels

Gateway sends two types of labels that allow you to search through Obcerv entities:

- Dimensions: these are the name-value pairs used to uniquely identify an Obcerv Entity.
- Attributes: these are observed pieces of information about an Obcerv entity, such as the `osType` of a Geneos Managed Entity.

Every metric has a set of dimensions that uniquely identify it. These are derived from the Geneos hierarchy of `gateway`, `managedEntity`, `sampler, type`, `dataview`, and `row`.

Geneos Managed Entity attributes set in the Gateway Setup Editor are sent as `ENTITY_ATTRIBUTE` metrics on the corresponding Obcerv entities in the `itrsgroup.com/geneos/gse` namespace. Gateway also sends each sampler's Group and PluginName as `ENTITY_ATTRIBUTE` metrics on the Obcerv entity representing that sampler.

Netprobe parameters, such as `HostName`, `Port`, `ConState`, `OS`, or `Version`, are sent as `ENTITY_ATTRIBUTE` metrics on each Obcerv entity representing a Geneos Managed Entity running on that Netprobe. The Netprobe also sends a sanitised version of `OS` called `osType`.

### Signals

Gateway sends severity changes to Obcerv as signals, and a signal stream is provided for every metric. Gateway sends the severity and the value on the cell at the time that the severity changed, and snooze events to Obcerv.

### Audit

Gateway sends audit events to Obcerv when a connection is established. Audit events originating from a Gateway will have a dimension of `gateway`. Audit events originating from a Netprobe (like running a command on a Netprobe) will have dimensions of both `gateway` and `probe`.

## Publish from Gateway to Obcerv

You can publish data from Gateway to Obcerv via the Ingestion service. This service is installed as part of your Obcerv installation.

By default, Gateway will publish all metrics, severity events, and audit events to Obcerv. You can configure filtering strategies to control what data is published to Obcerv. This can help minimise downstream data processing requirements in Obcerv. To configure include and exclude filters, see [Strategies](#strategies).

To start the connection between Gateway and Obcerv, you must configure the **Obcerv connection** in the **Publishing** settings in the Gateway Setup Editor. For more information, see [Obcerv connection configuration](#obcerv-connection-configuration).

![](https://docscdn.itrsgroup.com/geneos/images/gateway/gw-obcerv-connect-5-14.png)

Gateway self-monitoring, which is enabled by default, creates a dataview called Obcerv Connection that shows the current state of Obcerv publishing if the Obcerv Connection has been configured. For more information, see [Self-monitoring](#self-monitoring).

## Publish from Netprobes to Obcerv

You can publish log data from a Netprobe to Obcerv via the Obcerv Ingestion service. Currently, the log data collected by the FKM plugin can be published to Obcerv. To do this, you must:

1. [Configure the Obcerv connection in your Gateway](#basic-configuration).
2. Enable publishing for each FKM file in the Gateway Setup Editor. See [FKM Obcerv publishing](https://docs.itrsgroup.com/docs/geneos/current/collection/fkm-config/index.html#files--file--obcervpublishing).

  **Obcerv publishing is enabled**:
  ![FKM file publishes to Obcerv](https://docscdn.itrsgroup.com/geneos/images/plug-ins/fkm-obcerv-does-publish.png)

  **Obcerv publishing is not enabled**:
  ![FKM file does not publish to Obcerv](https://docscdn.itrsgroup.com/geneos/images/plug-ins/fkm-obcerv-does-not-publish.png)

## View Obcerv data in Active Console

If the Gateways connected to your Active Console publish data to Obcerv, then those Gateways will share the Obcerv connection details with Active Console so you can create history charts by querying data in Obcerv.

To allow a connected Active Console to access Obcerv data, you must configure the **Obcerv connection** in the **Data access** settings in the Gateway Setup Editor.

In Active Console, you must also ensure that **Tools** > **Settings** > **Geneos** > **Default data source** is set to `Obcerv`.

![](https://docscdn.itrsgroup.com/geneos/images/gateway/gw-obcerv-connect-5-14.png)

## Self-monitoring

When Obcerv publishing is configured on a Gateway, self-monitoring statistics are reported in two dataviews under **Gateway Info > Obcerv**.

### Detail dataview

![](https://docscdn.itrsgroup.com/geneos/images/obcerv-selfmon-details-5-13.png)

<div class="table-container">
<table xmlns="" class="legacy-table" style="width: 100%;margin-left: 0;margin-right: auto;mc-table-style: url('../../Resources/TableStyles/ref_3_col_table.css');" class="TableStyle-ref_3_col_table" cellspacing="0">
                        <col class="TableStyle-ref_3_col_table-Column-Column1"/>
                        <col class="TableStyle-ref_3_col_table-Column-Column1"/>
                        <thead>
                            <tr class="TableStyle-ref_3_col_table-Head-Header1">
                                <th class="TableStyle-ref_3_col_table-HeadE-Column1-Header1">Name</th>
                                <th class="TableStyle-ref_3_col_table-HeadD-Column1-Header1">Description</th>
                            </tr>
                        </thead>
                        <tbody>
                            <tr class="TableStyle-ref_3_col_table-Body-Body1">
                                <td class="TableStyle-ref_3_col_table-BodyE-Column1-Body1">name</td>
                                <td class="TableStyle-ref_3_col_table-BodyD-Column1-Body1">Name of the data type. </td>
                            </tr>
                            <tr class="TableStyle-ref_3_col_table-Body-Body1">
                                <td class="TableStyle-ref_3_col_table-BodyE-Column1-Body1">sendState</td>
                                <td class="TableStyle-ref_3_col_table-BodyD-Column1-Body1">Either <code>SENDING</code> or <code>BUFFERING</code>.</td>
                            </tr>
                            <tr class="TableStyle-ref_3_col_table-Body-Body1">
                                <td class="TableStyle-ref_3_col_table-BodyE-Column1-Body1">deliveryStatus</td>
                                <td class="TableStyle-ref_3_col_table-BodyD-Column1-Body1">Delivery status of the last message. This can be either <code>NONE</code>, <code>SUCCEEDED</code>, <code>RETRYING</code> or <code>FAILED</code>.</td>
                            </tr>
                            <tr class="TableStyle-ref_3_col_table-Body-Body1">
                                <td class="TableStyle-ref_3_col_table-BodyE-Column1-Body1">byteRate</td>
                                <td class="TableStyle-ref_3_col_table-BodyD-Column1-Body1">Transfer rate in bytes per second.</td>
                            </tr>
                            <tr class="TableStyle-ref_3_col_table-Body-Body1">
                                <td class="TableStyle-ref_3_col_table-BodyE-Column1-Body1">messagingRate</td>
                                <td class="TableStyle-ref_3_col_table-BodyD-Column1-Body1">Total transfer rate in messages per second across all three queues.</td>
                            </tr>
                            <tr class="TableStyle-ref_3_col_table-Body-Body1">
                                <td class="TableStyle-ref_3_col_table-BodyE-Column1-Body1">maxBufferSize</td>
                                <td class="TableStyle-ref_3_col_table-BodyD-Column1-Body1">Maximum number of buffered messages. </td>
                            </tr>
                            <tr class="TableStyle-ref_3_col_table-Body-Body1">
                                <td class="TableStyle-ref_3_col_table-BodyE-Column1-Body1">messagesInBuffer</td>
                                <td class="TableStyle-ref_3_col_table-BodyD-Column1-Body1">Current number of messages in the buffer.</td>
                            </tr>
                            <tr class="TableStyle-ref_3_col_table-Body-Body1">
                                <td class="TableStyle-ref_3_col_table-BodyE-Column1-Body1">messagesDroppedPerSample</td>
                                <td class="TableStyle-ref_3_col_table-BodyD-Column1-Body1">Number of messages dropped in the last sampler.</td>
                            </tr>
                            <tr class="TableStyle-ref_3_col_table-Body-Body1">
                                <td class="TableStyle-ref_3_col_table-BodyB-Column1-Body1"> </td>
                                <td class="TableStyle-ref_3_col_table-BodyA-Column1-Body1"> </td>
                            </tr>
                        </tbody>
                    </table>
                
</div>

### Summary dataview

![](https://docscdn.itrsgroup.com/geneos/images/obcerv-selfmon-summary-5-13.png)

<div class="table-container">
<table xmlns="" class="legacy-table" style="width: 100%;margin-left: 0;margin-right: auto;mc-table-style: url('../../Resources/TableStyles/ref_3_col_table.css');" class="TableStyle-ref_3_col_table" cellspacing="0">
                        <col class="TableStyle-ref_3_col_table-Column-Column1"/>
                        <col class="TableStyle-ref_3_col_table-Column-Column1"/>
                        <thead>
                            <tr class="TableStyle-ref_3_col_table-Head-Header1">
                                <th class="TableStyle-ref_3_col_table-HeadE-Column1-Header1">Name</th>
                                <th class="TableStyle-ref_3_col_table-HeadD-Column1-Header1">Description</th>
                            </tr>
                        </thead>
                        <tbody>
                            <tr class="TableStyle-ref_3_col_table-Body-Body1">
                                <td class="TableStyle-ref_3_col_table-BodyE-Column1-Body1">enabled</td>
                                <td class="TableStyle-ref_3_col_table-BodyD-Column1-Body1">The Obcerv connection can be either <code>Enabled</code> or <code>Disabled</code></td>
                            </tr>
                            <tr class="TableStyle-ref_3_col_table-Body-Body1">
                                <td class="TableStyle-ref_3_col_table-BodyE-Column1-Body1">connectionStatus</td>
                                <td class="TableStyle-ref_3_col_table-BodyD-Column1-Body1">Shows the connection status. This can be either  <code>Statistics only</code>, <code>Idle</code>, <code>Ready</code>, <code>Connecting</code>, <code>Transient Failure</code>, or <code>Shutdown</code>.</td>
                            </tr>
                            <tr class="TableStyle-ref_3_col_table-Body-Body1">
                                <td class="TableStyle-ref_3_col_table-BodyE-Column1-Body1">messageRate</td>
                                <td class="TableStyle-ref_3_col_table-BodyD-Column1-Body1">Transfer rate per queue in messages per second.</td>
                            </tr>
                            <tr class="TableStyle-ref_3_col_table-Body-Body1">
                                <td class="TableStyle-ref_3_col_table-BodyE-Column1-Body1">byteRate</td>
                                <td class="TableStyle-ref_3_col_table-BodyD-Column1-Body1">Transfer rate in bytes per second.</td>
                            </tr>
                            <tr class="TableStyle-ref_3_col_table-Body-Body1">
                                <td class="TableStyle-ref_3_col_table-BodyE-Column1-Body1">messagesDroppedPerSample</td>
                                <td class="TableStyle-ref_3_col_table-BodyD-Column1-Body1">Average number of messages dropped per sampler.</td>
                            </tr>
                            <tr class="TableStyle-ref_3_col_table-Body-Body1">
                                <td class="TableStyle-ref_3_col_table-BodyE-Column1-Body1">dataviewsPublished</td>
                                <td class="TableStyle-ref_3_col_table-BodyD-Column1-Body1">Number of dataviews published.</td>
                            </tr>
                            <tr class="TableStyle-ref_3_col_table-Body-Body1">
                                <td class="TableStyle-ref_3_col_table-BodyE-Column1-Body1">dataviewsUnpublished</td>
                                <td class="TableStyle-ref_3_col_table-BodyD-Column1-Body1">Number of dataviews unpublished. </td>
                            </tr>
                            <tr class="TableStyle-ref_3_col_table-Body-Body1">
                                <td class="TableStyle-ref_3_col_table-BodyE-Column1-Body1">dataviewsWithErrors</td>
                                <td class="TableStyle-ref_3_col_table-BodyD-Column1-Body1">Number of dataview with errors.</td>
                            </tr>
                            <tr class="TableStyle-ref_3_col_table-Body-Body1">
                                <td class="TableStyle-ref_3_col_table-BodyE-Column1-Body1">accessTokenUser</td>
                                <td class="TableStyle-ref_3_col_table-BodyD-Column1-Body1">
                                    <p>Obcerv user associated with the access token used to connect to Obcerv.</p>
                                    <p>Note, this is not an application key. Access tokens are short lived tokens used to secure connections. </p>
                                </td>
                            </tr>
                            <tr class="TableStyle-ref_3_col_table-Body-Body1">
                                <td class="TableStyle-ref_3_col_table-BodyE-Column1-Body1">accessTokenAvailable</td>
                                <td class="TableStyle-ref_3_col_table-BodyD-Column1-Body1">Status of access tokens. </td>
                            </tr>
                            <tr class="TableStyle-ref_3_col_table-Body-Body1">
                                <td class="TableStyle-ref_3_col_table-BodyB-Column1-Body1"> </td>
                                <td class="TableStyle-ref_3_col_table-BodyA-Column1-Body1"> </td>
                            </tr>
                        </tbody>
                    </table>
                
</div>

## Obcerv connection configuration

### Basic configuration

The Obcerv connection section of the GSE provides the following options:

![](https://docscdn.itrsgroup.com/geneos/images/gateway/gw-obcerv-connect-empty-6-1.png)

<div class="table-container">
<table xmlns="" class="legacy-table" style="width: 100%;margin-left: 0;margin-right: auto;mc-table-style: url('../../Resources/TableStyles/ref_3_col_table.css');" class="TableStyle-ref_3_col_table" cellspacing="0">
                        <col class="TableStyle-ref_3_col_table-Column-Column1"/>
                        <col class="TableStyle-ref_3_col_table-Column-Column1"/>
                        <col class="TableStyle-ref_3_col_table-Column-Column1"/>
                        <thead>
                            <tr class="TableStyle-ref_3_col_table-Head-Header1">
                                <th class="TableStyle-ref_3_col_table-HeadE-Column1-Header1">Setting</th>
                                <th class="TableStyle-ref_3_col_table-HeadE-Column1-Header1">Description</th>
                                <th class="TableStyle-ref_3_col_table-HeadD-Column1-Header1">Default</th>
                            </tr>
                        </thead>
                        <tbody>
                            <tr class="TableStyle-ref_3_col_table-Body-Body1">
                                <td class="TableStyle-ref_3_col_table-BodyE-Column1-Body1">Enabled<a name="enabled"/></td>
                                <td class="TableStyle-ref_3_col_table-BodyE-Column1-Body1">Enables or disables publishing to Obcerv. </td>
                                <td class="TableStyle-ref_3_col_table-BodyD-Column1-Body1">Enabled</td>
                            </tr>
                            <tr class="TableStyle-ref_3_col_table-Body-Body1">
                                <td class="TableStyle-ref_3_col_table-BodyE-Column1-Body1">Mode<a name="mode"/></td>
                                <td class="TableStyle-ref_3_col_table-BodyE-Column1-Body1">
                                    <p>Specify the publishing mode, choose from: </p>
                                    <ul>
                                        <li>
                                            <p>connection &#8212; publish Gateway data to Obcerv.</p>
                                        </li>
                                        <li>
                                            <p>statisticsOnly &#8212; perform a dry run using the current publishing settings. Statistics are recorded to the self-monitoring dataviews and to log files. </p>
                                        </li>
                                    </ul>
                                </td>
                                <td class="TableStyle-ref_3_col_table-BodyD-Column1-Body1">connection</td>
                            </tr>
                            <tr class="TableStyle-ref_3_col_table-Body-Body1">
                                <td class="TableStyle-ref_3_col_table-BodyB-Column1-Body1"> </td>
                                <td class="TableStyle-ref_3_col_table-BodyB-Column1-Body1"> </td>
                                <td class="TableStyle-ref_3_col_table-BodyA-Column1-Body1"> </td>
                            </tr>
                        </tbody>
                    </table>
                    
</div>

If the **Mode** is set to `connection`, then you can set up:

- Publishing — configure publishing from this Gateway to Obcerv.
- Data Access — allow an Active Console connected to this Gateway to access Obcerv data.

| Section | Setting | Description |
|-------|-------|-------|
| Connection | Verify server certificate | Enables or disables the server certificate verification.
If this parameter is set to `false` and the TLS is enabled, then the server certificate will not be checked when the connection is made, and the provided certificate will be accepted.
Default: True 
**Note**

 If the certificate supports Application-Layer Protocol Negotiation (ALPN), make sure that ALPN is set to `enabled` for Gateway and Obcerv connection to work properly. 
 |
| Connection | Root certificates | Specify the root CA certificate used to sign the ingestion service certificate. You can provide: - pemString — provide the full PEM string of the CA certificate. This can be found on the certificates page of the Obcerv Admin page in your Web Console.
- pemFile — provide the path to a file in the Gateway's current working directory. This file should contain the full PEM string of the CA certificate. A root certificate is not required if the certificate is already trusted by the host. |
| Connection > Publishing | Service address | Specify the Obcerv ingestion service hostname with the `http://` prefix. For example: `https://ingestion.my-obcerv.com`. 
**Note**

 The service address field defaults to `https` and port `443`, so that `https://ingest.hub.local:443` can be entered as `ingest.hub.local`. 
 |
| Connection > Publishing | Credentials | Specify the credentials used to access the Obcerv ingestion service.
You should provide a username and password in the Gateway Setup Editor. For more information about password configuration, see [Secure Passwords](https://docs.itrsgroup.com/docs/geneos/current/security/access-controls/gateway_secure_passwords/index.html). |
| Connection > Data access | Service address | Specify the Obcerv Web Console hostname. For example: `https://my-obcerv.com`.|
| Connection > Data access | Credentials | Specify the Obcerv user credentials to access data from Obcerv. The Obcerv username must have or should be part of a **user role**.
You should provide a username and password in the Gateway Setup Editor. For more information about password configuration, see [Secure Passwords](https://docs.itrsgroup.com/docs/geneos/current/security/access-controls/gateway_secure_passwords/index.html). |

### Advanced configuration

The **Additional settings** allow you to specify the following additional publishing settings that you may set individually:

![](https://docscdn.itrsgroup.com/geneos/images/gateway-obcerv-advanced-settings-6-1.png)

<div class="table-container">
<table class="legacy-table"   style="margin-left: 0;margin-right: auto;width: 100%;mc-table-style: url('../../Resources/TableStyles/ref_2_col_table.css');" cellspacing="0">
                    <col style="width: 290px;" class="TableStyle-ref_2_col_table-Column-Column1"/>
                    <col style="width: 50%;" class="TableStyle-ref_2_col_table-Column-Column1"/>
                    <thead>
                        <tr class="TableStyle-ref_2_col_table-Head-Header1">
                            <th class="TableStyle-ref_2_col_table-HeadE-Column1-Header1"><strong>Settings</strong>
                            </th>
                            <th class="TableStyle-ref_2_col_table-HeadD-Column1-Header1"><strong>Description</strong>
                            </th>
                        </tr>
                    </thead>
                    <tbody valign="top">
                        <tr class="TableStyle-ref_2_col_table-Body-Body1">
                            <td class="TableStyle-ref_2_col_table-BodyE-Column1-Body1">grpc.rpc.timeout
                            </td>
                            <td class="TableStyle-ref_2_col_table-BodyD-Column1-Body1">
                                <p>The time the Gateway waits for a gRPC response.</p>
                                <p>Default: <code>5000</code></p>
                                <p>Unit: milliseconds</p>
                                <p>Mandatory: No</p>
                            </td>
                        </tr>
                        <tr class="TableStyle-ref_2_col_table-Body-Body1">
                            <td class="TableStyle-ref_2_col_table-BodyE-Column1-Body1">grpc.batch.timeout
                            </td>
                            <td class="TableStyle-ref_2_col_table-BodyD-Column1-Body1">
                                <p>The time the Gateway waits before sending a batch of datapoints to Obcerv.</p>
                                <p>Default: <code>500</code> </p>
                                <p>Unit: milliseconds</p>
                                <p>Mandatory: No</p>
                            </td>
                        </tr>
                        <tr class="TableStyle-ref_2_col_table-Body-Body1">
                            <td class="TableStyle-ref_2_col_table-BodyE-Column1-Body1">grpc.batch.size
                            </td>
                            <td class="TableStyle-ref_2_col_table-BodyD-Column1-Body1">
                                <p>The maximum size a datapoint batch can have. Once the batch reaches the given size, it will be sent to Obcerv.</p>
                                <p>Default: <code>1000</code> </p>
                                <p>Unit: datapoints</p>
                                <p>Mandatory: No</p>
                            </td>
                        </tr>
                        <tr class="TableStyle-ref_2_col_table-Body-Body1">
                            <td class="TableStyle-ref_2_col_table-BodyE-Column1-Body1">grpc.queue.size</td>
                            <td class="TableStyle-ref_2_col_table-BodyD-Column1-Body1">
                                <p>The number of messages the Gateway can hold before it starts dropping message. This queue holds messages before being sent to Obcerv. The Gateway will attempt to keep this queue as small a possible.</p>
                                <p>Default: <code>50000</code></p>
                                <p>Mandatory: No</p>
                            </td>
                        </tr>
                        <tr class="TableStyle-ref_2_col_table-Body-Body1">
                            <td class="TableStyle-ref_2_col_table-BodyB-Column1-Body1"> </td>
                            <td class="TableStyle-ref_2_col_table-BodyA-Column1-Body1"> </td>
                        </tr>
                    </tbody>
                </table>
            
</div>

### Strategies

![](https://docscdn.itrsgroup.com/geneos/images/gateway/gw-filterStrategy-5-13.png)

<div class="table-container">
<table class="legacy-table" style="width: 100%;margin-left: 0;margin-right: auto;mc-table-style: url('../../Resources/TableStyles/ref_3_col_table.css');" class="TableStyle-ref_3_col_table" cellspacing="0">
                    <col class="TableStyle-ref_3_col_table-Column-Column1"/>
                    <col class="TableStyle-ref_3_col_table-Column-Column1"/>
                    <col class="TableStyle-ref_3_col_table-Column-Column1"/>
                    <thead>
                        <tr class="TableStyle-ref_3_col_table-Head-Header1">
                            <th class="TableStyle-ref_3_col_table-HeadE-Column1-Header1">Setting</th>
                            <th class="TableStyle-ref_3_col_table-HeadE-Column1-Header1">Description</th>
                            <th class="TableStyle-ref_3_col_table-HeadD-Column1-Header1">Default</th>
                        </tr>
                    </thead>
                    <tbody>
                        <tr class="TableStyle-ref_3_col_table-Body-Body1">
                            <td class="TableStyle-ref_3_col_table-BodyE-Column1-Body1">Name <a name="name"/></td>
                            <td class="TableStyle-ref_3_col_table-BodyE-Column1-Body1">
                                Specifies a name to uniquely identify the strategy.
                            </td>
                            <td class="TableStyle-ref_3_col_table-BodyD-Column1-Body1">New Strategy</td>
                        </tr>
                        <tr class="TableStyle-ref_3_col_table-Body-Body1">
                            <td class="TableStyle-ref_3_col_table-BodyE-Column1-Body1">Targets<a name="targets"/></td>
                            <td class="TableStyle-ref_3_col_table-BodyE-Column1-Body1">
                                One or more XPaths identifying the data items to which the strategy applies.
                                These XPaths must point to one or more Netprobes, Managed Entities, samplers, or dataviews. XPaths that reference run-time values such as severity or connection state, or XPaths that point to individual cells are not supported.
                            </td>
                            <td class="TableStyle-ref_3_col_table-BodyD-Column1-Body1"> </td>
                        </tr>
                        <tr class="TableStyle-ref_3_col_table-Body-Body1">
                            <td class="TableStyle-ref_3_col_table-BodyE-Column1-Body1">Options<a name="options"/></td>
                            <td class="TableStyle-ref_3_col_table-BodyE-Column1-Body1">
                                <p>Specifies what type of strategy to use. The following options are available:</p>
<ul>
<li>include filter — publish only the data items specified by the targets, their ancestors, and their descendants. The metrics, severity messages, snooze messages, and user assignment messages of all data items not explicitly or implicitly targeted are not published. Severity is propagated through published data based only on included data items.</li>
<li>exclude filter — do not publish the data items specified by the targets or their descendants. Metrics, severity messages, snooze messages, and user assignment messages are not published for any targeted data items. Severity is propagated through published data based only on data items which are not excluded.</li>
</ul>
<p>Note:  If you specify both include filters and exclude filters, a data item is published if it is selected (directly or as an ancestor or descendant) by at least one include target and it is not selected (directly or as a descendant) by any exclude target.</p>
                            </td>
                            <td class="TableStyle-ref_3_col_table-BodyD-Column1-Body1">filter</td>
                        </tr>
                        <tr class="TableStyle-ref_3_col_table-Body-Body1">
                            <td class="TableStyle-ref_3_col_table-BodyB-Column1-Body1"> </td>
                            <td class="TableStyle-ref_3_col_table-BodyB-Column1-Body1"> </td>
                            <td class="TableStyle-ref_3_col_table-BodyA-Column1-Body1"> </td>
                        </tr>
                    </tbody>
                </table>
            
</div>

### Strategy Group



Strategies may be grouped for organisational
 purposes. This has no effect on their application but
 is useful for grouping categories and making them
 easier to find in the navigation tree.


You must specify a name when creating a strategy group.






