Metadata-Version: 2.1
Name: opencensus-ext-newrelic
Version: 0.2.1
Summary: New Relic OpenCensus Exporter
Home-page: https://github.com/newrelic/newrelic-opencensus-exporter-python
Author: New Relic
Author-email: open-source@newrelic.com
License: Apache-2.0
Description: |header|
        
        .. |header| image:: https://github.com/newrelic/open-source-office/raw/master/examples/categories/images/Community_Project.png
            :target: https://github.com/newrelic/open-source-office/blob/master/examples/categories/index.md#category-community-project
        
        New Relic OpenCensus exporter
        =============================
        
        |ci| |coverage| |docs| |black|
        
        .. |ci| image:: https://github.com/newrelic/newrelic-opencensus-exporter-python/workflows/Tests/badge.svg
            :target: https://github.com/newrelic/newrelic-opencensus-exporter-python/actions?query=workflow%3ATests
        
        .. |coverage| image:: https://img.shields.io/codecov/c/github/newrelic/newrelic-opencensus-exporter-python/master
            :target: https://codecov.io/gh/newrelic/newrelic-opencensus-exporter-python
        
        .. |docs| image:: https://img.shields.io/badge/docs-available-brightgreen.svg
            :target: https://newrelic.github.io/newrelic-opencensus-exporter-python/
        
        .. |black| image:: https://img.shields.io/badge/code%20style-black-000000.svg
            :target: https://github.com/psf/black
        
        
        The ``opencensus-ext-newrelic`` package provides Python exporters to plug into
        `OpenCensus`_! Both spans and metrics may be exported using these exporters!
        
        .. _OpenCensus: https://opencensus.io
        
        
        Requirements
        ------------
        
        OpenCensus-Python version 0.7.x is required to use the exporters.
        
        Using the trace exporter
        ------------------------
        
        The example code assumes you've set the following environment variables:
        
        * ``NEW_RELIC_INSERT_KEY``
        
        .. code-block:: python
        
            import os
            import time
            from opencensus.trace.tracer import Tracer
            from opencensus.trace import samplers
            from opencensus_ext_newrelic import NewRelicTraceExporter
        
            newrelic = NewRelicTraceExporter(
                insert_key=os.environ["NEW_RELIC_INSERT_KEY"], service_name="Example Service"
            )
        
            tracer = Tracer(exporter=newrelic, sampler=samplers.AlwaysOnSampler())
        
            with tracer.span(name="main") as span:
                time.sleep(0.5)
        
            # Send all data and stop the exporter
            newrelic.stop()
        
        
        Using the stats exporter
        ------------------------
        
        Metrics are an excellent way to expose aggregated information about your
        application. The stats exporter allows metrics to be exported from opencensus
        to New Relic.
        
        The example code assumes you've set the following environment variables:
        
        * ``NEW_RELIC_INSERT_KEY``
        
        .. code-block:: python
        
            import os
            import time
            from opencensus.stats import aggregation as aggregation_module
            from opencensus.stats import measure as measure_module
            from opencensus.stats import stats as stats_module
            from opencensus.stats import view as view_module
            from opencensus_ext_newrelic import NewRelicStatsExporter
        
            # The stats recorder
            stats = stats_module.stats
            view_manager = stats.view_manager
            stats_recorder = stats.stats_recorder
            newrelic = NewRelicStatsExporter(
                os.environ["NEW_RELIC_INSERT_KEY"], service_name="Example Service"
            )
            view_manager.register_exporter(newrelic)
        
            # Create the measures and views
            # The latency in milliseconds
            m_latency_ms = measure_module.MeasureFloat(
                "task_latency", "The task latency in milliseconds", "ms"
            )
        
            latency_view = view_module.View(
                "task_latency_latest",
                "The latest task latency",
                [],
                m_latency_ms,
                aggregation_module.LastValueAggregation(),
            )
        
            view_manager.register_view(latency_view)
            mmap = stats_recorder.new_measurement_map()
        
            # Record a metric
            mmap.measure_float_put(m_latency_ms, 50)
            mmap.record()
        
            # Send all data and stop the exporter
            newrelic.stop()
        
        
        Find and use data
        -----------------
        
        Tips on how to find and query your data in New Relic:
        
        * `Find metric data <https://docs.newrelic.com/docs/data-ingest-apis/get-data-new-relic/metric-api/introduction-metric-api#find-data>`_
        * `Find trace/span data <https://docs.newrelic.com/docs/understand-dependencies/distributed-tracing/trace-api/introduction-trace-api#view-data>`_
        
        For general querying information, see:
        
        * `Query New Relic data <https://docs.newrelic.com/docs/using-new-relic/data/understand-data/query-new-relic-data>`_
        * `Intro to NRQL <https://docs.newrelic.com/docs/query-data/nrql-new-relic-query-language/getting-started/introduction-nrql>`_
        
Platform: any
Classifier: Development Status :: 3 - Alpha
Classifier: Topic :: System :: Monitoring
Classifier: Programming Language :: Python :: Implementation :: PyPy
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Operating System :: OS Independent
Classifier: License :: OSI Approved :: Apache Software License
Requires-Python: !=3.0.*,!=3.1.*,!=3.2.*,!=3.3.*,!=3.4.*,>=2.7
Description-Content-Type: text/x-rst
