> ## Documentation Index
> Fetch the complete documentation index at: https://gcore-doc-1256a.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Prometheus exporter

## What is Prometheus exporter?

The Prometheus exporter is a service that offers OpenSearch index metrics to clients. It provides secure access to user-specific metrics for authenticated users.

## How does it work?

You configure your Prometheus target, providing the Prometheus exporter endpoint and your Managed Logging credentials using HTTPS Basic Authentication. To get the URL endpoint for your region, open the **Prometheus exporter endpoint** tab and copy the API link.

<Frame>
  <img src="https://mintcdn.com/gcore-doc-1256a/ZnNFjl9KkjcJVP9a/images/docs/cloud/laas/Logging.jpg?fit=max&auto=format&n=ZnNFjl9KkjcJVP9a&q=85&s=ea0d7a4a80dde29582f1677aabc2f200" alt="How does it work" width="701" height="456" data-path="images/docs/cloud/laas/Logging.jpg" />
</Frame>

For example, the Prometheus target configuration for Luxembourg would look like this:

```yaml theme={null}
- job_name: 'your_awesome_job'
  scrape_interval: 5m
  scrape_timeout: 30s
  scheme: https
  static_configs:
      - targets: ['laas-exporter.k1.luxembourg-1.cloud.gcore.com']
  metrics_path: "/v1/opensearch/indices/metrics"
  basic_auth:
    username: 'yourLaasUsername'
    password: 'yourLaasPassword'
```

The Prometheus exporter endpoint for your region in specified in the Gcore Customer Portal.

## Understand the key metrics

The table below explains the key metrics provided by the Prometheus exporter. These metrics offer valuable insights into the health and usage of your Managed Logging environment.

| Metric                                                                 | Description                                                                                    | Type  |
| ---------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------- | ----- |
| opensearch\_index\_stats\_index\_current                               | The number of documents currently being indexed to a specific index                            | gauge |
| opensearch\_index\_stats\_query\_cache\_size                           | The total size of the query cache                                                              | gauge |
| opensearch\_index\_stats\_search\_scroll\_current                      | The current count of search scrolls                                                            | gauge |
| opensearch\_indices\_completion \_bytes\_primary                       | The current size of completion data with only primary shards across all nodes in bytes         | gauge |
| opensearch\_indices\_deleted\_docs\_primary                            | The count of deleted documents with only primary shards                                        | gauge |
| opensearch\_indices\_docs\_primary                                     | The count of documents with only primary shards                                                | gauge |
| opensearch\_indices\_mappings\_stats\_fields                           | The current number of fields within the cluster                                                | gauge |
| opensearch\_indices\_segment\_count\_primary                           | The current number of segments with only primary shards across all nodes                       | gauge |
| opensearch\_indices\_segment \_doc\_values\_memory\_bytes\_primary     | The current size of doc values with only primary shards across all nodes in bytes              | gauge |
| opensearch\_indices\_segment \_fields\_memory\_bytes\_primary          | The current size of fields with only primary shards across all nodes in bytes                  | gauge |
| opensearch\_indices\_segment \_fixed\_bit\_set\_memory\_bytes\_primary | The current size of fixed bit sets with only primary shards across all nodes in bytes          | gauge |
| opensearch\_indices\_segment \_index\_writer\_memory\_bytes\_primary   | The current size of index writer with only primary shards across all nodes in bytes            | gauge |
| opensearch\_indices\_segment \_memory\_bytes\_primary                  | The current size of segments with only primary shards across all nodes in bytes                | gauge |
| opensearch\_indices\_segment \_norms\_memory\_bytes\_primary           | The current size of norms with only primary shards across all nodes in bytes                   | gauge |
| opensearch\_indices\_segment \_points\_memory\_bytes\_primary          | The current size of points with only primary shards across all nodes in bytes                  | gauge |
| opensearch\_indices\_segment \_term\_vectors\_memory\_primary\_bytes   | The current size of term vectors with only primary shards across all nodes in bytes            | gauge |
| opensearch\_indices\_segment \_terms\_memory\_primary                  | The current size of terms with only primary shards across all nodes in bytes                   | gauge |
| opensearch\_indices\_segment \_version\_map\_memory\_bytes\_primary    | The current size of version map with only primary shards across all nodes in bytes             | gauge |
| opensearch\_indices\_settings \_total\_fields                          | The index mapping setting for "total\_fields"                                                  | gauge |
| opensearch\_indices\_store \_size\_bytes\_primary                      | The current total size of stored index data in bytes with only primary shards across all nodes | gauge |
| opensearch\_search\_active\_queries                                    | The number of currently active queries                                                         | gauge |
