---
title: "Obcerv connection"
description: ""
url: "https://docs.itrsgroup.com/docs/geneos/current/collection/obcerv-connection/index.html"
---
## Introduction

The Obcerv Connection plugin monitors the state of the connection that publishes logs to Obcerv from a Netprobe. It is automatically added to Netprobe and FIX Analyser 2 Netprobe which publishes log data directly to Obcerv. The plugin has two dataviews:

- Summary
- Detail


**Note**

 
The Publisher plugin creates its own connection to Obcerv and includes a dataview showing metrics for that connection. These metrics are separate from those shown by this plugin.



### Summary

The summary dataview provides general information regarding publishing from the Netprobe to Obcerv.

#### Table legend

The **table cells** display the following data:
<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: 50%;" class="TableStyle-ref_2_col_table-Column-Column1">
                    </col>
                    <col style="width: 50%;" class="TableStyle-ref_2_col_table-Column-Column1">
                    </col>
                    <thead>
                        <tr class="TableStyle-ref_2_col_table-Head-Header1">
                            <th class="TableStyle-ref_2_col_table-HeadE-Column1-Header1">Column Name</th>
                            <th class="TableStyle-ref_2_col_table-HeadD-Column1-Header1">Description</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">byteRate</td>
                            <td class="TableStyle-ref_2_col_table-BodyD-Column1-Body1"> 	Bytes per second published to Obcerv, summed over all message types shown in Detail view</td>
                        </tr>
                        <tr class="TableStyle-ref_2_col_table-Body-Body1">
                            <td class="TableStyle-ref_2_col_table-BodyE-Column1-Body1">connectionStatus</td>
                            <td class="TableStyle-ref_2_col_table-BodyD-Column1-Body1">
                                <p>Indicates the status of the gRPC connection to Obcerv. This has the following possible values: </p>
                                <ul>
                                    <li>
                                        <p>Idle</p>
                                    </li>
                                    <li xmlns="">
                                        <p>Ready</p>
                                    </li>
                                    <li xmlns="">
                                        <p>Connecting</p>
                                    </li>
                                    <li xmlns="">
                                        <p>Transient Failure</p>
                                    </li>
                                    <li xmlns="">
                                        <p>Shutdown</p>
                                    </li>
                                    <li xmlns="">
                                        <p>Statistics Only (see Mode setting in  <a href="https://docs.itrsgroup.com/docs/geneos/current/processing/data-access-and-publishing/connect_geneos_to_obcerv/index.html">Obcerv Connection</a>)</p>
                                    </li>
                                </ul>
                            </td>
                        </tr>
                        <tr class="TableStyle-ref_2_col_table-Body-Body1">
                            <td class="TableStyle-ref_2_col_table-BodyE-Column1-Body1">enabled</td>
                            <td class="TableStyle-ref_2_col_table-BodyD-Column1-Body1">Indicates whether the Obcerv connection is enabled.</td>
                        </tr>
                        <tr class="TableStyle-ref_2_col_table-Body-Body1">
                            <td class="TableStyle-ref_2_col_table-BodyE-Column1-Body1">messageRate</td>
                            <td class="TableStyle-ref_2_col_table-BodyD-Column1-Body1"> 	The rate at which messages are sent to Obcerv, measured as the number of messages per second.</td>
                        </tr>
                        <tr class="TableStyle-ref_2_col_table-Body-Body1">
                            <td class="TableStyle-ref_2_col_table-BodyE-Column1-Body1">messagesDroppedPerSample</td>
                            <td class="TableStyle-ref_2_col_table-BodyD-Column1-Body1">Number of messages dropped in the last sample.</td>
                        </tr>
                        <tr class="TableStyle-ref_2_col_table-Body-Body1">
                            <td class="TableStyle-ref_2_col_table-BodyE-Column1-Body1">samplerCount</td>
                            <td class="TableStyle-ref_2_col_table-BodyD-Column1-Body1">Number of samplers that publish logs directly to Obcerv.</td>
                        </tr>
                        <tr class="TableStyle-ref_2_col_table-Body-Body1">
                        </tr>
                    </tbody>
                </table>
                
</div>

### Detail dataview

The detail dataview shows separate message statistics for the different types of messages that may be published.

#### Table legend

<div class="table-container">
    <table class="legacy-table"
        style="margin-left: 0;margin-right: auto;width: 100%;mc-table-style: url('../TableStyles/ref_2_col_table.css');"
        cellspacing="0">
        <col style="width: 50%;" class="TableStyle-ref_2_col_table-Column-Column1">
        </col>
        <col style="width: 50%;" class="TableStyle-ref_2_col_table-Column-Column1">
        </col>
        <thead>
            <tr class="TableStyle-ref_2_col_table-Head-Header1">
                <th class="TableStyle-ref_2_col_table-HeadE-Column1-Header1">Column Name</th>
                <th class="TableStyle-ref_2_col_table-HeadD-Column1-Header1">Description</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">name</td>
                <td class="TableStyle-ref_2_col_table-BodyD-Column1-Body1">
                    <p>The message type. Possible values include:</p>
                    <ul>
                        <li>
                            ENTITY ATTRIBUTES
                        </li>
                        <li>
                            EVENTS
                        </li>
                        <li>
                            LOGS
                        </li>
                        <li>
                            METRICS
                        </li>
                    </ul>
                </td>
            </tr>
            <tr class="TableStyle-ref_2_col_table-Body-Body1">
                <td class="TableStyle-ref_2_col_table-BodyE-Column1-Body1">sendState</td>
                <td class="TableStyle-ref_2_col_table-BodyD-Column1-Body1">
                    <p>The current state of the queue for the message type. Possible values include:</p>
                    <ul>
                        <li xmlns="">
                            <p>SENDING</p>
                        </li>
                        <li xmlns="">
                            <p>BUFFERING (the connection status is not yet "Ready")</p>
                        </li>
                        <li xmlns="">
                            <p>SIMULATING (the connection is set to statistics only mode)</p>
                        </li>
                    </ul>
                </td>
            </tr>
            <tr class="TableStyle-ref_2_col_table-Body-Body1">
                <td class="TableStyle-ref_2_col_table-BodyE-Column1-Body1">deliveryStatus</td>
                <td class="TableStyle-ref_2_col_table-BodyD-Column1-Body1">
                    <p> The delivery status of the last message batch sent. Possible values include:</p>
                    <ul>
                        <li xmlns="">
                            <p>(blank) (No batch has been sent yet for this message type)</p>
                        </li>
                        <li xmlns="">
                            <p>SUCCEEDED</p>
                        </li>
                        <li xmlns="">
                            <p>RETRYING</p>
                        </li>
                        <li xmlns="">
                            <p>FAILED</p>
                        </li>
                        <li xmlns="">
                            <p>"N/A" (the connection is set to statistics only mode)</p>
                        </li>
                    </ul>
                </td>
            </tr>
            <tr class="TableStyle-ref_2_col_table-Body-Body1">
                <td class="TableStyle-ref_2_col_table-BodyE-Column1-Body1">byteRate</td>
                <td class="TableStyle-ref_2_col_table-BodyD-Column1-Body1">Bytes per second published to Obcerv for this
                    type of message.</td>
            </tr>
            <tr class="TableStyle-ref_2_col_table-Body-Body1">
                <td class="TableStyle-ref_2_col_table-BodyE-Column1-Body1">messageRate</td>
                <td class="TableStyle-ref_2_col_table-BodyD-Column1-Body1"> The rate at which messages are sent to
                    Obcerv, measured as the number of messages per second. </td>
            </tr>
            <tr class="TableStyle-ref_2_col_table-Body-Body1">
                <td class="TableStyle-ref_2_col_table-BodyE-Column1-Body1">maxBufferSize</td>
                <td class="TableStyle-ref_2_col_table-BodyD-Column1-Body1">Configured maximum number of messages that
                    can be buffered.</td>
            </tr>
            <tr class="TableStyle-ref_2_col_table-Body-Body1">
                <td class="TableStyle-ref_2_col_table-BodyE-Column1-Body1">messagesInBuffer</td>
                <td class="TableStyle-ref_2_col_table-BodyD-Column1-Body1">Number of messages buffered in the queue for
                    the message type.</td>
            </tr>
            <tr class="TableStyle-ref_2_col_table-Body-Body1">
                <td class="TableStyle-ref_2_col_table-BodyE-Column1-Body1">messagesDroppedPerSample</td>
                <td class="TableStyle-ref_2_col_table-BodyD-Column1-Body1">Number of messages dropped in the last
                    sample.</td>
            </tr>
        </tbody>
    </table>

</div>


