Monitoring your usage

This page shows you how to monitor the overall usage and costs for your Pinecone organization as well as usage and performance metrics for individual indexes.

​

Monitor organization-level usage

To view usage and costs for your Pinecone organization, go to Settings > Usage in the Pinecone console.

All dates are given in UTC to match billing invoices.

​

Monitor index-level usage

To view usage and performance metrics for an index:

1. Open the Pinecone console.
2. Select the project containing the index you want to monitor.
3. Select the index.
4. Go to the Metrics tab.

​

Monitor operation-level usage

Read operations like query and fetch return a usage parameter with the read unit consumption of each call that is made. For example, a simple query to an example index might return this result and summary of read unit usage:

from pinecone import Pinecone

pc = Pinecone(api_key="YOUR_API_KEY")
index = pc.Index("pinecone-index")

index.query(
  vector=[0.3, 0.3, 0.3, 0.3, 0.3, 0.3, 0.3, 0.3],
  top_k=3,
  include_values=True
)
# Returns:
# {
#     "matches": [
#         {
#             "id": "C",
#             "score": -1.76717265e-07,
#             "values": [0.3, 0.3, 0.3, 0.3, 0.3, 0.3, 0.3, 0.3],
#         },
#         {
#             "id": "B",
#             "score": 0.080000028,
#             "values": [0.2, 0.2, 0.2, 0.2, 0.2, 0.2, 0.2, 0.2],
#         },
#         {
#             "id": "D",
#             "score": 0.0800001323,
#             "values": [0.4, 0.4, 0.4, 0.4, 0.4, 0.4, 0.4, 0.4],
#         },
#     ],
#     "namespace": "",
#     "usage": {"read_units": 5}
# }

For a more in-depth demonstration of how to use read units to inspect read costs, see this notebook.

​

See also

• Understanding cost
• Managing cost