--- title: Prometheus Metrics description: This content covers the Prometheus statistics and metrics collected and made available by Sync Gateway pubDate: 2026-08-17T09:53:44.266Z antora: editUrl: https://github.com/couchbase/docs-sync-gateway/edit/release/4.1/modules/manage/pages/stats-monitoring-prometheus.adoc xref: xref:sync-gateway:manage:stats-monitoring-prometheus.adoc[] --- [Consult the llms.txt file for a full list of contents](/llms.txt) [View original HTML](/sync-gateway/current/manage/stats-monitoring-prometheus.html) # Prometheus Metrics > This content covers the Prometheus statistics and metrics collected and made available by Sync Gateway > Sync Gateway's statistics and metrics provide under-the-hood data on the performance, resource utilization and health of it nodes. This is increasingly important as deployments scale to support a large numbers of connected mobile and edge components. Related _inter-syncgateway_ topics: [Legacy Pre-3.0 Configuration](../configuration/configuration-properties-legacy.md) | [Metrics REST API](../rest-api/rest-api-metrics.md) | [Prometheus Integration](../deploy/stats-prometheus.md) ## [](#prometheus-format)Prometheus format Like other Couchbase services, Sync Gateway offers [Prometheus-compatible metrics](../deploy/stats-prometheus.md) in a flat JSON format. Use the `metrics` endpoint to request these metrics: Example 1\. Metrics in Prometheus format ```console curl -X GET "http://localhost:4986/metrics" -H "accept: application/json" ``` This endpoint's data will be scraped at configurable interval, when the `metricsInterface` is activated and Sync Gateway integrated with Prometheus — see: [Integrate Prometheus](../deploy/stats-prometheus.md) and our blog entry [Monitoring Couchbase Sync Gateway with Prometheus and Grafana](https://blog.couchbase.com/monitoring-sync-gateway-prometheus-grafana/). The response in Prometheus format is defined as follows: > [!TIP] > * The x.y.z badge shows the Sync Gateway version the metric was added in. > * The type / unit badge shows shows the Prometheus [type](https://prometheus.io/docs/tutorials/understanding%5Fmetric%5Ftypes/) and [unit](https://prometheus.io/docs/practices/naming/#base-units) (if present). > * The Database and Collection badges show the scope of the metric. If not scoped to Database or Collection, the metric applies to the Sync Gateway as a whole. | sgw\_audit\_num\_audits\_filtered\_by\_role3.2.1 counter The total number of audit events filtered by role. | | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | sgw\_audit\_num\_audits\_filtered\_by\_user3.2.1 counter The total number of audit events filtered by user. | | sgw\_audit\_num\_audits\_logged3.2.1 counter The total number of audit events logged. | | sgw\_cache\_abandoned\_seqs3.0.0 counter database The total number of skipped sequences abandoned, based on cache.channel\_cache.max\_wait\_skipped. | | sgw\_cache\_chan\_cache\_active\_revs3.0.0 gauge database The total number of active revisions in the channel cache. | | sgw\_cache\_chan\_cache\_bypass\_count3.0.0 counter database The total number of transient bypass channel caches created to serve requests when the channel cache was at capacity. | | sgw\_cache\_chan\_cache\_channels\_added3.0.0 counter database The total number of channel caches added. The metric doesn't decrease when a channel is removed. That is, it is similar to chan\_cache\_num\_channels but doesn't track removals. | | sgw\_cache\_chan\_cache\_channels\_evicted\_inactive3.0.0 counter database The total number of channel cache channels evicted due to inactivity. | | sgw\_cache\_chan\_cache\_channels\_evicted\_nru3.0.0 counter database The total number of active channel cache channels evicted, based on 'not recently used' criteria. | | sgw\_cache\_chan\_cache\_compact\_count3.0.0 counter database The total number of channel cache compaction runs. | | sgw\_cache\_chan\_cache\_compact\_time3.0.0 counter / nanoseconds database The total amount of time taken by channel cache compaction across all compaction runs. | | sgw\_cache\_chan\_cache\_hits3.0.0 counter database The total number of channel cache requests fully served by the cache. This metric is useful in calculating the channel cache hit ratio: channel cache hit ratio = chan\_cache\_hits / (chan\_cache\_hits + chan\_cache\_misses) | | sgw\_cache\_chan\_cache\_max\_entries3.0.0 gauge database The total size of the largest channel cache. This metric helps with channel cache tuning, and provides a hint on cache size variation (when compared to average cache size). | | sgw\_cache\_chan\_cache\_misses3.0.0 counter database The total number of channel cache requests not fully served by the cache. This metric is useful when calculating the channel cache hit ratio: channel cache hit ratio = chan\_cache\_hits / (chan\_cache\_hits + chan\_cache\_misses) | | sgw\_cache\_chan\_cache\_num\_channels3.0.0 gauge database The total number of channels being cached. The total number of channels being cached provides insight into potential max cache size requirements and also node usage (for example, chan\_cache\_num\_channels \* max\_cache\_size). | | sgw\_cache\_chan\_cache\_pending\_queries3.0.0 gauge database The total number of channel cache pending queries. | | sgw\_cache\_chan\_cache\_removal\_revs3.0.0 gauge database The total number of removal revisions in the channel cache. This metric acts as a reminder that removals must be considered when tuning the channel cache size and also helps users understand whether they should be tuning tombstone retention policy (metadata purge interval) and running compact. | | sgw\_cache\_chan\_cache\_tombstone\_revs3.0.0 gauge database The total number of tombstone revisions in the channel cache. This metric acts as a reminder that tombstones and removals must be considered when tuning the channel cache size and also helps users understand whether they should be tuning tombstone retention policy (metadata purge interval), and running compact. | | sgw\_cache\_current\_skipped\_seq\_count3.2.0 counter database The number of sequences currently in the skipped sequence slice. | | sgw\_cache\_high\_seq\_cached3.0.0 counter database The highest sequence number cached. Note: There may be skipped sequences lower than high\_seq\_cached. | | sgw\_cache\_high\_seq\_stable3.0.0 counter database The highest contiguous sequence number that has been cached. | | sgw\_cache\_non\_mobile\_ignored\_count3.0.0 counter database Number of non mobile documents that were ignored off the cache feed. | | sgw\_cache\_num\_active\_channels3.0.0 gauge database The total number of active channels. | | sgw\_cache\_num\_skipped\_seqs3.0.0 counter database The total number of skipped sequences. This is a cumulative value | | sgw\_cache\_pending\_seq\_len3.0.0 gauge database The total number of pending sequences. These are out-of-sequence entries waiting to be cached. | | sgw\_cache\_rev\_cache\_bypass3.0.0 gauge database The total number of revision cache bypass operations performed. | | sgw\_cache\_rev\_cache\_hits3.0.0 counter database The total number of revision cache hits. This metric can be used to calculate the ratio of revision cache hits: Rev Cache Hit Ratio = rev\_cache\_hits / (rev\_cache\_hits + rev\_cache\_misses) | | sgw\_cache\_rev\_cache\_misses3.0.0 counter database The total number of revision cache misses. This metric can be used to calculate the ratio of revision cache misses: Rev Cache Miss Ratio = rev\_cache\_misses / (rev\_cache\_hits + rev\_cache\_misses) | | sgw\_cache\_revision\_cache\_num\_items3.2.1 gauge database The total number of items in the revision cache. | | sgw\_cache\_revision\_cache\_total\_memory3.2.1 gauge database The approximation of total memory taken up by rev cache for documents. This is measured by the raw document body, the channels allocated to a document and its revision history. | | sgw\_cache\_skipped\_seq\_cap3.2.0 gauge database The current capacity of the skipped sequence slice. | | sgw\_cache\_skipped\_seq\_len3.0.0 gauge database The current length of the pending skipped sequence slice. | | sgw\_cache\_view\_queries3.0.0 counter database The total view\_queries. | | sgw\_collection\_doc\_reads\_bytes3.1.0 counter / bytes collection database The total number of bytes read from this collection as part of document writes since Sync Gateway node startup. | | sgw\_collection\_doc\_writes\_bytes3.1.0 counter / bytes collection database The total number of bytes written to this collection as part of document writes since Sync Gateway node startup. | | sgw\_collection\_import\_count3.1.0 counter collection database The total number of documents imported to this collection since Sync Gateway node startup. | | sgw\_collection\_num\_doc\_reads3.1.0 counter collection database The total number of documents read from this collection since Sync Gateway node startup (i.e. sending to a client) | | sgw\_collection\_num\_doc\_writes3.1.0 counter collection database The total number of documents written to this collection since Sync Gateway node startup (i.e. receiving from a client) | | sgw\_collection\_sync\_function\_count3.0.0 counter collection database The total number of times that the sync\_function is evaluated for this collection. | | sgw\_collection\_sync\_function\_exception\_count3.1.0 counter collection database The total number of times the sync function encountered an exception for this collection. | | sgw\_collection\_sync\_function\_reject\_access\_count3.1.0 counter collection database The total number of documents rejected by write access functions (requireAccess, requireRole, requireUser) for this collection. | | sgw\_collection\_sync\_function\_reject\_count3.1.0 counter collection database The total number of documents rejected by the sync\_function for this collection. | | sgw\_collection\_sync\_function\_time3.0.0 counter / nanoseconds collection database The total time spent evaluating the sync\_function for this keyspace. | | sgw\_config\_database\_config\_bucket\_mismatches3.1.2 counter / bytes The total number of times a database config is polled from a bucket that doesn't match the bucket specified in the database config. | | sgw\_config\_database\_config\_collection\_conflicts3.1.4 counter / bytes The total number of times a database config is rolled back to an invalid state (collection conflicts). | | sgw\_database\_compaction\_attachment\_start\_time3.0.0 gauge / unix timestamp database The compaction\_attachment\_start\_time | | sgw\_database\_compaction\_tombstone\_start\_time3.0.0 gauge / unix timestamp database The compaction\_tombstone\_start\_time. | | sgw\_database\_conflict\_write\_count3.0.0 counter database The total number of writes that left the document in a conflicted state. Includes new conflicts, and mutations that don't resolve existing conflicts. | | sgw\_database\_crc32c\_match\_count3.0.0 gauge database The total number of instances during import when the document cas had changed, but the document was not imported because the document body had not changed. | | sgw\_database\_dcp\_caching\_count3.0.0 gauge database The total number of DCP mutations added to Sync Gateway's channel cache. Can be used with dcp\_caching\_time to monitor cache processing latency. That is, the time between seeing a change on the DCP feed and when it's available in the channel cache: DCP cache latency = dcp\_caching\_time / dcp\_caching\_count | | sgw\_database\_dcp\_caching\_time3.0.0 gauge / nanoseconds database The total time between a DCP mutation arriving at Sync Gateway and being added to channel cache. This metric can be used with dcp\_caching\_count to monitor cache processing latency. That is, the time between seeing a change on the DCP feed and when it's available in the channel cache: dcp\_cache\_latency = dcp\_caching\_time / dcp\_caching\_count | | sgw\_database\_dcp\_received\_count3.0.0 gauge database The total number of document mutations received by Sync Gateway over DCP. | | sgw\_database\_dcp\_received\_time3.0.0 gauge / nanoseconds database The time between a document write and that document being received by Sync Gateway over DCP. If the document was written prior to Sync Gateway starting the feed, it is recorded as the time since the feed was started. This metric can be used to monitor DCP feed processing latency | | sgw\_database\_doc\_reads\_bytes\_blip3.0.0 counter / bytes database The total number of bytes read via Couchbase Lite 2.x replication since Sync Gateway node startup. | | sgw\_database\_doc\_writes\_bytes3.0.0 counter / bytes database The total number of bytes written as part of document writes since Sync Gateway node startup. | | sgw\_database\_doc\_writes\_bytes\_blip3.0.0 counter / bytes database The total number of bytes written as part of Couchbase Lite document writes since Sync Gateway node startup. | | sgw\_database\_doc\_writes\_xattr\_bytes3.0.0 counter / bytes database The total size of xattrs written (in bytes). | | sgw\_database\_high\_seq\_feed3.0.0 counter database Highest sequence number seen on the caching DCP feed. | | sgw\_database\_http\_bytes\_written3.2.0 counter / bytes database Number of bytes written over public interface for REST api | | sgw\_database\_num\_attachments\_compacted3.0.0 counter database The number of attachments compacted import\_feed | | sgw\_database\_num\_doc\_reads\_blip3.0.0 counter database The total number of documents read via Couchbase Lite 2.x replication since Sync Gateway node startup. | | sgw\_database\_num\_doc\_reads\_rest3.0.0 counter database The total number of documents read via the REST API since Sync Gateway node startup. Includes Couchbase Lite 1.x replication. | | sgw\_database\_num\_doc\_writes3.0.0 counter database The total number of documents written by any means (replication, rest API interaction or imports) since Sync Gateway node startup. | | sgw\_database\_num\_idle\_kv\_ops3.1.3.1 counter The total number of idle kv operations. | | sgw\_database\_num\_public\_rest\_requests3.2.0 counter database The total number of requests sent over the public REST api. | | sgw\_database\_num\_replications\_active3.0.0 gauge database The total number of active replications. | | sgw\_database\_num\_replications\_rejected\_limit3.2.0 counter database The total number of times a replication connection is rejected due to it being over the threshold. | | sgw\_database\_num\_replications\_total3.0.0 counter database The total number of replications created since Sync Gateway node startup. | | sgw\_database\_num\_tombstones\_compacted3.0.0 counter database Number of tombstones compacted through tombstone compaction task on the database. | | sgw\_database\_public\_rest\_bytes\_read3.2.0 counter / bytes database The total amount of bytes read over the public REST api | | sgw\_database\_replication\_bytes\_received3.2.0 counter / bytes database Total bytes received over replications to the database. | | sgw\_database\_replication\_bytes\_sent3.2.0 counter / bytes database Total bytes sent over replications from the database. | | sgw\_database\_sequence\_assigned\_count3.0.0 counter database The total number of sequence numbers assigned. | | sgw\_database\_sequence\_get\_count3.0.0 counter database The total number of high sequence lookups. | | sgw\_database\_sequence\_incr\_count3.0.0 counter database The total number of times the sequence counter document has been incremented. | | sgw\_database\_sequence\_released\_count3.0.0 counter database The total number of unused, reserved sequences released by Sync Gateway. | | sgw\_database\_sequence\_reserved\_count3.0.0 counter database The total number of sequences reserved by Sync Gateway. | | sgw\_database\_sync\_function\_count3.1.0 counter database The total number of times that the sync\_function is evaluated. The {sync\_function\_count\_ stat is useful in assessing the usage of the sync\_function, when used in conjunction with the sync\_function\_time. | | sgw\_database\_sync\_function\_exception\_count3.0.0 counter database The total number of times that a sync function encountered an exception (across all collections). | | sgw\_database\_sync\_function\_time3.1.0 counter / nanoseconds database The total time spent evaluating the sync\_function. The sync\_function\_time stat can be useful when: (a). Troubleshooting excessively long push times, where it can help identify potential sync\_function bottlenecks (for example, those arising from complex, or inefficient, sync\_function design. (b). Assessing the overall contribution of the sync\_function processing to overall push replication write times. | | sgw\_database\_total\_sync\_time3.2.0 counter / seconds database The total total sync time is a proxy for websocket connections. Tracking long lived and potentially idle connections. This stat represents the continually growing number of connections per sec. | | sgw\_database\_warn\_channel\_name\_size\_count3.0.0 counter database The total number of warnings relating to the channel name size. | | sgw\_database\_warn\_channels\_per\_doc\_count3.0.0 counter database The total number of warnings relating to the channel count exceeding the channel count threshold. | | sgw\_database\_warn\_grants\_per\_doc\_count3.0.0 counter database The total number of warnings relating to the grant count exceeding the grant count threshold. | | sgw\_database\_warn\_xattr\_size\_count3.0.0 counter database The total number of warnings relating to the xattr sync data being larger than a configured threshold. | | sgw\_delta\_sync\_delta\_cache\_hit3.0.0 counter database The total number of requested deltas that were available in the revision cache. | | sgw\_delta\_sync\_delta\_pull\_replication\_count3.0.0 counter database The number of delta replications that have been run. | | sgw\_delta\_sync\_delta\_push\_doc\_count3.0.0 counter database The total number of documents pushed as a delta from a previous revision. | | sgw\_delta\_sync\_delta\_sync\_miss3.0.0 counter database The total number of requested deltas that were not available in the revision cache. | | sgw\_delta\_sync\_deltas\_requested3.0.0 counter database The total number of times a revision is sent as delta from a previous revision. | | sgw\_delta\_sync\_deltas\_sent3.0.0 counter database The total number of revisions sent to clients as deltas. | | sgw\_gsi\_views\_\_count3.0.0 counter database The total number of gsi/view queries performed. | | sgw\_gsi\_views\_\_error\_count3.0.0 counter database The total number of errors that occurred when performing the gsi/view query | | sgw\_gsi\_views\_\_time3.0.0 counter / nanoseconds database The total time taken to perform gsi/view queries. | | sgw\_replication\_expected\_sequence\_len3.1.0 counter database replication The length of expectedSeqs list in the ISGR checkpointer. | | sgw\_replication\_expected\_sequence\_len\_post\_cleanup3.1.0 counter database replication The length of expectedSeqs list in the ISGR checkpointer after the cleanup task has been run. | | sgw\_replication\_processed\_sequence\_len3.1.0 counter database replication The length of processedSeqs list in the ISGR checkpointer. | | sgw\_replication\_processed\_sequence\_len\_post\_cleanup3.1.0 counter database replication The length of processedSeqs list in the ISGR checkpointer after the cleanup task has been run. | | sgw\_replication\_pull\_attachment\_pull\_bytes3.0.0 counter / bytes database The total size of attachments pulled. This is the pre-compressed size. | | sgw\_replication\_pull\_attachment\_pull\_count3.0.0 counter database The total number of attachments pulled. | | sgw\_replication\_pull\_max\_pending3.0.0 gauge database The high watermark for the number of documents buffered during feed processing, waiting on a missing earlier sequence. | | sgw\_replication\_pull\_norev\_send\_count3.2.0 counter database The total number of norev messages sent during replication. | | sgw\_replication\_pull\_num\_pull\_repl\_active\_continuous3.0.0 gauge database The total number of continuous pull replications in the active state. | | sgw\_replication\_pull\_num\_pull\_repl\_active\_one\_shot3.0.0 gauge database The total number of one-shot pull replications in the active state. | | sgw\_replication\_pull\_num\_pull\_repl\_caught\_up3.0.0 gauge database The total number of replications which have caught up to the latest changes. | | sgw\_replication\_pull\_num\_pull\_repl\_since\_zero3.0.0 counter database The total number of new replications started (/\_changes?since=0). | | sgw\_replication\_pull\_num\_pull\_repl\_total\_caught\_up3.0.0 gauge database The total number of pull replications which have caught up to the latest changes across all replications. | | sgw\_replication\_pull\_num\_pull\_repl\_total\_continuous3.0.0 gauge database The total number of continuous pull replications. | | sgw\_replication\_pull\_num\_pull\_repl\_total\_one\_shot3.0.0 gauge database The total number of one-shot pull replications. | | sgw\_replication\_pull\_num\_replications\_active3.0.0 gauge database The total number of active replications. | | sgw\_replication\_pull\_replacement\_rev\_send\_count3.2.0 counter database The total number of replacement revisions sent instead of a norev during replication. | | sgw\_replication\_pull\_request\_changes\_count3.0.0 counter database The total number of changes requested. This metric can be used to calculate the latency of requested changes: changes request latency = request\_changes\_time / request\_changes\_count | | sgw\_replication\_pull\_request\_changes\_time3.0.0 counter / nanoseconds database Total time taken to handle changes request response. This metric can be used to calculate the latency of requested changes: changes request latency = request\_changes\_time / request\_changes\_count | | sgw\_replication\_pull\_rev\_error\_count3.2.0 counter database The total number of rev messages that were failed to be processed during replication. | | sgw\_replication\_pull\_rev\_processing\_time3.0.0 gauge / nanoseconds database The total amount of time processing rev messages (revisions) during pull revision. This metric can be used with rev\_send\_count to calculate the average processing time per revision: average processing time per revision = rev\_processing\_time / rev\_send\_count | | sgw\_replication\_pull\_rev\_send\_count3.0.0 counter database The total number of rev messages processed during replication. This metric can be used with rev\_processing\_time to calculate the average processing time per revision: average processing time per revision = rev\_processing\_time / rev\_send\_count | | sgw\_replication\_pull\_rev\_send\_latency3.0.0 counter / nanoseconds database The total amount of time between Sync Gateway receiving a request for a revision and that revision being sent. In a pull replication, Sync Gateway sends a /\_changes request to the client and the client responds with the list of revisions it wants to receive. So, rev\_send\_latency measures the time between the client asking for those revisions and Sync Gateway sending them to the client. Note: Measuring time from the /\_changes response means that this stat will vary significantly depending on the changes batch size A larger batch size will result in a spike of this stat, even if the processing time per revision is unchanged. A more useful stat might be the average processing time per revision: average processing time per revision = rev\_processing\_time\] / rev\_send\_count | | sgw\_replication\_push\_attachment\_push\_bytes3.0.0 counter / bytes database The total number of attachment bytes pushed. | | sgw\_replication\_push\_attachment\_push\_count3.0.0 counter database The total number of attachments pushed. | | sgw\_replication\_push\_doc\_push\_count3.0.0 gauge database The total number of documents pushed. | | sgw\_replication\_push\_doc\_push\_error\_count3.0.0 gauge database The total number of documents that failed to push. | | sgw\_replication\_push\_propose\_change\_count3.0.0 counter database The total number of changes and-or proposeChanges messages processed since node start-up. The propose\_change\_count stat can be useful when: (a). Assessing the number of redundant requested changes being pushed by the client. Do this by comparing the propose\_change\_count value with the number of actual writes num\_doc\_writes, which could indicate that clients are pushing changes already known to Sync Gateway. (b). Identifying situations where push replications are unexpectedly being restarted from zero. | | sgw\_replication\_push\_propose\_change\_time3.0.0 counter / nanoseconds database The total time spent processing changes and/or proposeChanges messages. The propose\_change\_time stat can be useful in diagnosing push replication issues arising from potential bottlenecks changes and-or proposeChanges processing. Note: The propose\_change\_time is not included in the write\_processing\_time | | sgw\_replication\_push\_write\_processing\_time3.0.0 gauge / nanoseconds database Total time spent processing writes. Measures complete request-to-response time for a write. The write\_processing\_time stat can be useful when: (a). Determining the average time per write: average time per write = write\_processing\_time / num\_doc\_writes stat value (b). Assessing the benefit of adding additional Sync Gateway nodes, as it can point to Sync Gateway being a bottleneck (c). Troubleshooting slow push replication, in which case it ought to be considered in conjunction with sync\_function\_time | | sgw\_replication\_push\_write\_throttled\_count3.1.4 counter database The total number of times a revision was throttled during push replication from clients. The write\_throttled\_count stat can be useful to to determine an appropriate limit of concurrent revisions for each client. There's a direct tradeoff with memory and CPU usage for replicating clients and large amounts of concurrent revisions. | | sgw\_replication\_push\_write\_throttled\_time3.1.4 counter / nanoseconds database The total time (in nanoseconds) waiting for an available slot to handle a pushed revision after being throttled. The write\_throttled\_time stat can be useful to determine whether clients are waiting too long for an available slot to push a revision. There's a direct tradeoff with memory and CPU usage for replicating clients and large amounts of concurrent revisions. | | sgw\_replication\_sgr\_conflict\_resolved\_local\_count3.0.0 counter database replication The total number of conflicting documents that were resolved successfully locally (by the active replicator) | | sgw\_replication\_sgr\_conflict\_resolved\_merge\_count3.0.0 counter database replication The total number of conflicting documents that were resolved successfully by a merge action (by the active replicator) | | sgw\_replication\_sgr\_conflict\_resolved\_remote\_count3.0.0 counter database replication The total number of conflicting documents that were resolved successfully remotely (by the active replicator) | | sgw\_replication\_sgr\_deltas\_recv3.0.0 counter database replication The total number of documents that were purged since replication started. | | sgw\_replication\_sgr\_deltas\_requested3.0.0 counter database replication The total number of deltas requested. | | sgw\_replication\_sgr\_deltas\_sent3.0.0 counter database replication The total number of deltas sent. | | sgw\_replication\_sgr\_docs\_checked\_recv3.0.0 counter database replication The total number of document changes received over changes message. | | sgw\_replication\_sgr\_docs\_checked\_sent3.0.0 counter database replication The total number of documents checked for changes since replication started. This represents the number of potential change notifications pushed by Sync Gateway. This is not necessarily the number of documents pushed, as a given target might already have the change and this is used by Inter-Sync Gateway and SG Replicate. This metric can be useful when analyzing replication history, and to filter by active replications. | | sgw\_replication\_sgr\_num\_attachment\_bytes\_pulled3.0.0 counter / bytes database replication The total number of bytes in all the attachments that were pulled since replication started. | | sgw\_replication\_sgr\_num\_attachment\_bytes\_pushed3.0.0 counter / bytes database replication The total number of bytes in all the attachments that were pushed since replication started. | | sgw\_replication\_sgr\_num\_attachments\_pulled3.0.0 counter database replication The total number of attachments that were pulled since replication started. | | sgw\_replication\_sgr\_num\_attachments\_pushed3.0.0 counter database replication The total number of attachments that were pushed since replication started. | | sgw\_replication\_sgr\_num\_connect\_attempts\_pull3.0.0 counter database replication Number of connection attempts made for pull replication connection. | | sgw\_replication\_sgr\_num\_connect\_attempts\_push3.0.0 counter database replication Number of connection attempts made for push replication connection. | | sgw\_replication\_sgr\_num\_docs\_failed\_to\_pull3.0.0 counter database replication The total number of document pulls that failed since replication started. | | sgw\_replication\_sgr\_num\_docs\_failed\_to\_push3.0.0 counter database replication The total number of documents that failed to be pushed since replication started. Used by Inter-Sync Gateway and SG Replicate. | | sgw\_replication\_sgr\_num\_docs\_pulled3.0.0 counter database replication The total number of documents that were pulled since replication started. | | sgw\_replication\_sgr\_num\_docs\_purged3.0.0 counter database replication The total number of documents that were purged since replication started. | | sgw\_replication\_sgr\_num\_docs\_pushed3.0.0 counter database replication The total number of documents that were pushed since replication started. Used by Inter-Sync Gateway and SG Replicate. | | sgw\_replication\_sgr\_num\_handlers\_panicked3.1.0 counter database replication The number of times a handler panicked and didn't know how to recover from it. | | sgw\_replication\_sgr\_num\_reconnects\_aborted\_pull3.0.0 counter database replication Number of times pull replication connection reconnect loops have failed. | | sgw\_replication\_sgr\_num\_reconnects\_aborted\_push3.0.0 counter database replication Number of times push replication connection reconnect loops have failed. | | sgw\_replication\_sgr\_push\_conflict\_count3.0.0 counter database replication The total number of pushed documents that conflicted since replication started. | | sgw\_replication\_sgr\_push\_rejected\_count3.0.0 counter database replication The total number of pushed documents that were rejected since replication started. | | sgw\_resource\_utilization\_admin\_net\_bytes\_recv3.0.0 counter / bytes The total number of bytes received (since node start-up) on the network interface to which the Sync Gateway api.admin\_interface is bound. By default, that is the number of bytes received on 127.0.0.1:4985 since node start-up. | | sgw\_resource\_utilization\_admin\_net\_bytes\_sent3.0.0 counter / bytes The total number of bytes sent (since node start-up) on the network interface to which the Sync Gateway api.admin\_interface is bound.By default, that is the number of bytes sent on 127.0.0.1:4985 since node start-up. | | sgw\_resource\_utilization\_error\_count3.0.0 counter The total number of errors logged. | | sgw\_resource\_utilization\_go\_memstats\_heapalloc3.0.0 gauge / bytes HeapAlloc is bytes of allocated heap objects. "Allocated" heap objects include all reachable objects, as well as unreachable objects that the garbage collector has not yet freed. Specifically, HeapAlloc increases as heap objects are allocated and decreases as the heap is swept and unreachable objects are freed. Sweeping occurs incrementally between GC cycles, so these two processes occur simultaneously, and as a result HeapAlloc tends to change smoothly (in contrast with the sawtooth that istypical of stop-the-world garbage collectors). | | sgw\_resource\_utilization\_go\_memstats\_heapidle3.0.0 gauge / bytes HeapIdle is bytes in idle (unused) spans. Idle spans have no objects in them. These spans could be (and may already have been) returned to the OS, or they can be reused for heap allocations, or they can be reused as stack memory. HeapIdle minus HeapReleased estimates the amount of memory that could be returned to the OS, but is being retained by the runtime so it can grow the heap without requesting more memory from the OS. If this difference is significantly larger than the heap size, it indicates there was a recent transient spike in live heap size. | | sgw\_resource\_utilization\_go\_memstats\_heapinuse3.0.0 gauge / bytes HeapInuse is bytes in in-use spans. In-use spans have at least one object in them. These spans an only be used for other objects of roughly the same size. HeapInuse minus HeapAlloc estimates the amount of memory that has been dedicated to particular size classes, but is not currently being used. This is an upper bound on fragmentation, but in general this memory can be reused efficiently. | | sgw\_resource\_utilization\_go\_memstats\_heapreleased3.0.0 gauge / bytes HeapReleased is bytes of physical memory returned to the OS. This counts heap memory from idle spans that was returned to the OS and has not yet been reacquired for the heap. | | sgw\_resource\_utilization\_go\_memstats\_pausetotalns3.0.0 gauge / nanoseconds PauseTotalNs is the cumulative nanoseconds in GC stop-the-world pauses since the program started. During a stop-the-world pause, all goroutines are paused and only the garbage collector can run. | | sgw\_resource\_utilization\_go\_memstats\_stackinuse3.0.0 gauge / bytes StackInuse is bytes in stack spans. In-use stack spans have at least one stack in them. These spans can only be used for other stacks of the same size. There is no StackIdle because unused stack spans are returned to the heap (and hence counted toward HeapIdle). | | sgw\_resource\_utilization\_go\_memstats\_stacksys3.0.0 gauge / bytes StackSys is bytes of stack memory obtained from the OS. StackSys is StackInuse, plus any memory obtained directly from the OS for OS thread stacks (which should be minimal). | | sgw\_resource\_utilization\_go\_memstats\_sys3.0.0 gauge / bytes Sys is the total bytes of memory obtained from the OS. Sys is the sum of the XSys fields below. Sys measures the virtual address space reserved by the Go runtime for the heap, stacks, and other internal data structures. It's likely that not all of the virtual address space is backed by physical memory at any given moment, though in general it all was at some point. | | sgw\_resource\_utilization\_goroutines\_high\_watermark3.0.0 gauge Peak number of go routines since process start. | | sgw\_resource\_utilization\_node\_cpu\_percent\_utilization3.2.0 gauge / percent The node CPU utilization as percentage value, since the last time this stat was called. The CPU usage calculation is performed based on user and system CPU time, but it does not include components such as iowait. | | sgw\_resource\_utilization\_num\_goroutines3.0.0 gauge The total number of goroutines. | | sgw\_resource\_utilization\_process\_cpu\_percent\_utilization3.0.0 gauge / percent The CPU's utilization as percentage value \* 10\. The extra 10 multiplier is a mistake left for backwards compatibility. Please consider using node\_cpu\_percent\_utilization. The CPU usage calculation is performed based on user and system CPU time, but it does not include components such as iowait. The derivation means that the values of process\_cpu\_percent\_utilization and %Cpu, returned when running the top command, will differ | | sgw\_resource\_utilization\_process\_memory\_resident3.0.0 gauge / bytes The memory utilization (Resident Set Size) for the process, in bytes. | | sgw\_resource\_utilization\_pub\_net\_bytes\_recv3.0.0 counter / bytes The total number of bytes received (since node start-up) on the network interface to which the Sync Gateway api.public\_interface is bound. By default, that is the number of bytes received on 127.0.0.1:4984 since node start-up | | sgw\_resource\_utilization\_pub\_net\_bytes\_sent3.0.0 counter / bytes The total number of bytes sent (since node start-up) on the network interface to which Sync Gateway api.public\_interface is bound. By default, that is the number of bytes sent on 127.0.0.1:4984 since node start-up. | | sgw\_resource\_utilization\_system\_memory\_total3.0.0 gauge / bytes The total memory available on the system in bytes. | | sgw\_resource\_utilization\_uptime3.0.0 counter / nanoseconds The total uptime. | | sgw\_resource\_utilization\_warn\_count3.0.0 counter The total number of warnings logged. | | sgw\_security\_auth\_failed\_count3.0.0 counter database The total number of unsuccessful authentications. This metric is useful in monitoring the number of authentication errors. | | sgw\_security\_auth\_success\_count3.0.0 counter database The total number of successful authentications. This metric is useful in monitoring the number of authenticated requests. | | sgw\_security\_num\_access\_errors3.0.0 counter database The total number of documents rejected by write access functions (requireAccess, requireRole, requireUser). | | sgw\_security\_num\_docs\_rejected3.0.0 counter database The total number of documents rejected by the sync\_function. | | sgw\_security\_total\_auth\_time3.0.0 gauge / nanoseconds database The total time spent in authenticating all requests. This metric can be compared with auth\_success\_count and auth\_failed\_count to derive an average success and-or fail rate. | | sgw\_shared\_bucket\_import\_import\_cancel\_cas3.0.0 counter database The total number of imports cancelled due to cas failure. | | sgw\_shared\_bucket\_import\_import\_count3.0.0 counter database The total number of docs imported. | | sgw\_shared\_bucket\_import\_import\_error\_count3.0.0 counter database The total number of errors arising as a result of a document import. | | sgw\_shared\_bucket\_import\_import\_high\_seq3.0.0 counter database The highest sequence number value imported. | | sgw\_shared\_bucket\_import\_import\_partitions3.0.0 gauge database The total number of import partitions. | | sgw\_shared\_bucket\_import\_import\_processing\_time3.0.0 gauge / nanoseconds database The total time taken to process a document import. |