OpenTelemetry Google Cloud Monitoring Exporter
==============================================
.. image:: https://badge.fury.io/py/opentelemetry-exporter-gcp-monitoring.svg
:target: https://badge.fury.io/py/opentelemetry-exporter-gcp-monitoring
.. image:: https://readthedocs.org/projects/google-cloud-opentelemetry/badge/?version=latest
:target: https://google-cloud-opentelemetry.readthedocs.io/en/latest/?badge=latest
:alt: Documentation Status
This library provides support for exporting metrics to Google Cloud
Monitoring.
For resource detection and GCP trace context propagation, see
`opentelemetry-tools-google-cloud
<https://pypi.org/project/opentelemetry-tools-google-cloud/>`_. For the
Google Cloud Trace exporter, see `opentelemetry-exporter-gcp-trace
<https://pypi.org/project/opentelemetry-exporter-gcp-trace/>`_.
Installation
------------
.. code:: bash
pip install opentelemetry-exporter-gcp-monitoring
Usage
-----
.. code:: python
import time
from opentelemetry import metrics
from opentelemetry.exporter.cloud_monitoring import (
CloudMonitoringMetricsExporter,
)
from opentelemetry.sdk.metrics import MeterProvider
from opentelemetry.sdk.metrics.export import PeriodicExportingMetricReader
from opentelemetry.sdk.resources import Resource
metrics.set_meter_provider(
MeterProvider(
metric_readers=[
PeriodicExportingMetricReader(
CloudMonitoringMetricsExporter(), export_interval_millis=5000
)
],
resource=Resource.create(
{
"service.name": "basic_metrics",
"service.namespace": "examples",
"service.instance.id": "instance123",
}
),
)
)
meter = metrics.get_meter(__name__)
# Creates metric workload.googleapis.com/request_counter with monitored resource generic_task
requests_counter = meter.create_counter(
name="request_counter",
description="number of requests",
unit="1",
)
staging_labels = {"environment": "staging"}
for i in range(20):
requests_counter.add(25, staging_labels)
time.sleep(5)
References
----------
* `Cloud Monitoring <https://cloud.google.com/monitoring>`_
* `OpenTelemetry Project <https://opentelemetry.io/>`_
Raw data
{
"_id": null,
"home_page": "https://github.com/GoogleCloudPlatform/opentelemetry-operations-python/tree/main/opentelemetry-exporter-gcp-monitoring",
"name": "opentelemetry-exporter-gcp-monitoring",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.7",
"maintainer_email": "",
"keywords": "",
"author": "Google",
"author_email": "opentelemetry-pypi@google.com",
"download_url": "https://files.pythonhosted.org/packages/68/5e/4d2b827407e47f7fb44834e0afaa9b95cb5a2670320b7f8440c48a94aa47/opentelemetry-exporter-gcp-monitoring-1.6.0a0.tar.gz",
"platform": "any",
"description": "OpenTelemetry Google Cloud Monitoring Exporter\n==============================================\n\n.. image:: https://badge.fury.io/py/opentelemetry-exporter-gcp-monitoring.svg\n :target: https://badge.fury.io/py/opentelemetry-exporter-gcp-monitoring\n\n.. image:: https://readthedocs.org/projects/google-cloud-opentelemetry/badge/?version=latest\n :target: https://google-cloud-opentelemetry.readthedocs.io/en/latest/?badge=latest\n :alt: Documentation Status\n\nThis library provides support for exporting metrics to Google Cloud\nMonitoring.\n\nFor resource detection and GCP trace context propagation, see\n`opentelemetry-tools-google-cloud\n<https://pypi.org/project/opentelemetry-tools-google-cloud/>`_. For the\nGoogle Cloud Trace exporter, see `opentelemetry-exporter-gcp-trace\n<https://pypi.org/project/opentelemetry-exporter-gcp-trace/>`_.\n\nInstallation\n------------\n\n.. code:: bash\n\n pip install opentelemetry-exporter-gcp-monitoring\n\nUsage\n-----\n\n.. code:: python\n\n import time\n\n from opentelemetry import metrics\n from opentelemetry.exporter.cloud_monitoring import (\n CloudMonitoringMetricsExporter,\n )\n from opentelemetry.sdk.metrics import MeterProvider\n from opentelemetry.sdk.metrics.export import PeriodicExportingMetricReader\n from opentelemetry.sdk.resources import Resource\n\n metrics.set_meter_provider(\n MeterProvider(\n metric_readers=[\n PeriodicExportingMetricReader(\n CloudMonitoringMetricsExporter(), export_interval_millis=5000\n )\n ],\n resource=Resource.create(\n {\n \"service.name\": \"basic_metrics\",\n \"service.namespace\": \"examples\",\n \"service.instance.id\": \"instance123\",\n }\n ),\n )\n )\n meter = metrics.get_meter(__name__)\n\n # Creates metric workload.googleapis.com/request_counter with monitored resource generic_task\n requests_counter = meter.create_counter(\n name=\"request_counter\",\n description=\"number of requests\",\n unit=\"1\",\n )\n\n staging_labels = {\"environment\": \"staging\"}\n\n for i in range(20):\n requests_counter.add(25, staging_labels)\n time.sleep(5)\n\n\nReferences\n----------\n\n* `Cloud Monitoring <https://cloud.google.com/monitoring>`_\n* `OpenTelemetry Project <https://opentelemetry.io/>`_\n",
"bugtrack_url": null,
"license": "Apache-2.0",
"summary": "Google Cloud Monitoring exporter for OpenTelemetry",
"version": "1.6.0a0",
"project_urls": {
"Homepage": "https://github.com/GoogleCloudPlatform/opentelemetry-operations-python/tree/main/opentelemetry-exporter-gcp-monitoring"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "07a99f36862e19b6e726876d0c3f8b9b0457583846620914297b2ea11097872f",
"md5": "13796c360a0749e53ae8fb5c610ba0b8",
"sha256": "c1b8bdaa4ccee8160d195362ae6d9a3099975d357441cbb1c29046cc63673077"
},
"downloads": -1,
"filename": "opentelemetry_exporter_gcp_monitoring-1.6.0a0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "13796c360a0749e53ae8fb5c610ba0b8",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.7",
"size": 12930,
"upload_time": "2023-10-16T22:12:06",
"upload_time_iso_8601": "2023-10-16T22:12:06.510639Z",
"url": "https://files.pythonhosted.org/packages/07/a9/9f36862e19b6e726876d0c3f8b9b0457583846620914297b2ea11097872f/opentelemetry_exporter_gcp_monitoring-1.6.0a0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "685e4d2b827407e47f7fb44834e0afaa9b95cb5a2670320b7f8440c48a94aa47",
"md5": "75e7943a4fece3cd79880f0c1d791540",
"sha256": "d29059de11c0133b670914da82ee14f06299da896fbfbceea61161b464316a58"
},
"downloads": -1,
"filename": "opentelemetry-exporter-gcp-monitoring-1.6.0a0.tar.gz",
"has_sig": false,
"md5_digest": "75e7943a4fece3cd79880f0c1d791540",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.7",
"size": 19509,
"upload_time": "2023-10-16T22:12:13",
"upload_time_iso_8601": "2023-10-16T22:12:13.161496Z",
"url": "https://files.pythonhosted.org/packages/68/5e/4d2b827407e47f7fb44834e0afaa9b95cb5a2670320b7f8440c48a94aa47/opentelemetry-exporter-gcp-monitoring-1.6.0a0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-10-16 22:12:13",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "GoogleCloudPlatform",
"github_project": "opentelemetry-operations-python",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"tox": true,
"lcname": "opentelemetry-exporter-gcp-monitoring"
}
JSON
