| <!DOCTYPE html> |
| |
| <html lang="en" data-content_root="./"> |
| <head> |
| <meta charset="utf-8" /> |
| <meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="viewport" content="width=device-width, initial-scale=1" /> |
| |
| <title>gRPC Python Observability — gRPC Python 1.76.0 documentation</title> |
| <link rel="stylesheet" type="text/css" href="_static/pygments.css?v=5ecbeea2" /> |
| <link rel="stylesheet" type="text/css" href="_static/alabaster.css?v=f0f94f3a" /> |
| <script src="_static/documentation_options.js?v=8c3e8212"></script> |
| <script src="_static/doctools.js?v=9a2dae69"></script> |
| <script src="_static/sphinx_highlight.js?v=dc90522c"></script> |
| <link rel="index" title="Index" href="genindex.html" /> |
| <link rel="search" title="Search" href="search.html" /> |
| <link rel="next" title="Glossary" href="glossary.html" /> |
| <link rel="prev" title="gRPC Testing" href="grpc_testing.html" /> |
| |
| <link rel="stylesheet" href="_static/custom.css" type="text/css" /> |
| |
| |
| |
| |
| |
| </head><body> |
| <div class="document"> |
| |
| <div class="sphinxsidebar" role="navigation" aria-label="Main"> |
| <div class="sphinxsidebarwrapper"> |
| <h1 class="logo"><a href="index.html">gRPC Python</a></h1> |
| |
| |
| |
| <p class="blurb">1.76.0</p> |
| |
| |
| |
| |
| |
| |
| <h3>Navigation</h3> |
| <p class="caption" role="heading"><span class="caption-text">Contents:</span></p> |
| <ul class="current"> |
| <li class="toctree-l1"><a class="reference internal" href="grpc.html">gRPC</a></li> |
| <li class="toctree-l1"><a class="reference internal" href="grpc_asyncio.html">gRPC AsyncIO API</a></li> |
| <li class="toctree-l1"><a class="reference internal" href="grpc_admin.html">gRPC Admin</a></li> |
| <li class="toctree-l1"><a class="reference internal" href="grpc_channelz.html">gRPC Channelz</a></li> |
| <li class="toctree-l1"><a class="reference internal" href="grpc_csds.html">gRPC CSDS</a></li> |
| <li class="toctree-l1"><a class="reference internal" href="grpc_health_checking.html">gRPC Health Checking</a></li> |
| <li class="toctree-l1"><a class="reference internal" href="grpc_reflection.html">gRPC Reflection</a></li> |
| <li class="toctree-l1"><a class="reference internal" href="grpc_status.html">gRPC Status</a></li> |
| <li class="toctree-l1"><a class="reference internal" href="grpc_testing.html">gRPC Testing</a></li> |
| <li class="toctree-l1 current"><a class="current reference internal" href="#">gRPC Python Observability</a><ul> |
| <li class="toctree-l2"><a class="reference internal" href="#module-grpc_observability">Module Contents</a><ul> |
| <li class="toctree-l3"><a class="reference internal" href="#grpc_observability.OpenTelemetryPlugin"><code class="docutils literal notranslate"><span class="pre">OpenTelemetryPlugin</span></code></a><ul> |
| <li class="toctree-l4"><a class="reference internal" href="#grpc_observability.OpenTelemetryPlugin.deregister_global"><code class="docutils literal notranslate"><span class="pre">OpenTelemetryPlugin.deregister_global()</span></code></a></li> |
| <li class="toctree-l4"><a class="reference internal" href="#grpc_observability.OpenTelemetryPlugin.register_global"><code class="docutils literal notranslate"><span class="pre">OpenTelemetryPlugin.register_global()</span></code></a></li> |
| </ul> |
| </li> |
| </ul> |
| </li> |
| </ul> |
| </li> |
| <li class="toctree-l1"><a class="reference internal" href="glossary.html">Glossary</a></li> |
| </ul> |
| |
| <div class="relations"> |
| <h3>Related Topics</h3> |
| <ul> |
| <li><a href="index.html">Documentation overview</a><ul> |
| <li>Previous: <a href="grpc_testing.html" title="previous chapter">gRPC Testing</a></li> |
| <li>Next: <a href="glossary.html" title="next chapter">Glossary</a></li> |
| </ul></li> |
| </ul> |
| </div> |
| <search id="searchbox" style="display: none" role="search"> |
| <h3 id="searchlabel">Quick search</h3> |
| <div class="searchformwrapper"> |
| <form class="search" action="search.html" method="get"> |
| <input type="text" name="q" aria-labelledby="searchlabel" autocomplete="off" autocorrect="off" autocapitalize="off" spellcheck="false"/> |
| <input type="submit" value="Go" /> |
| </form> |
| </div> |
| </search> |
| <script>document.getElementById('searchbox').style.display = "block"</script> |
| |
| |
| |
| |
| |
| |
| |
| |
| </div> |
| </div> |
| <div class="documentwrapper"> |
| <div class="bodywrapper"> |
| |
| |
| <div class="body" role="main"> |
| |
| <section id="grpc-python-observability"> |
| <h1>gRPC Python Observability<a class="headerlink" href="#grpc-python-observability" title="Link to this heading">¶</a></h1> |
| <section id="module-grpc_observability"> |
| <span id="module-contents"></span><h2>Module Contents<a class="headerlink" href="#module-grpc_observability" title="Link to this heading">¶</a></h2> |
| <dl class="py class"> |
| <dt class="sig sig-object py" id="grpc_observability.OpenTelemetryPlugin"> |
| <em class="property"><span class="pre">class</span><span class="w"> </span></em><span class="sig-prename descclassname"><span class="pre">grpc_observability.</span></span><span class="sig-name descname"><span class="pre">OpenTelemetryPlugin</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="o"><span class="pre">*</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">plugin_options</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">meter_provider</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">target_attribute_filter</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">generic_method_attribute_filter</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc_observability/_open_telemetry_plugin.html#OpenTelemetryPlugin"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#grpc_observability.OpenTelemetryPlugin" title="Link to this definition">¶</a></dt> |
| <dd><p>Describes a Plugin for OpenTelemetry observability.</p> |
| <dl class="field-list simple"> |
| <dt class="field-odd">Parameters<span class="colon">:</span></dt> |
| <dd class="field-odd"><ul class="simple"> |
| <li><p><strong>plugin_options</strong> (<em>Iterable</em><em>[</em><em>OpenTelemetryPluginOption</em><em>]</em>)</p></li> |
| <li><p><strong>meter_provider</strong> (<em>MeterProvider</em><em> | </em><em>None</em>)</p></li> |
| <li><p><strong>target_attribute_filter</strong> (<em>Callable</em><em>[</em><em>[</em><em>str</em><em>]</em><em>, </em><em>bool</em><em>]</em>)</p></li> |
| <li><p><strong>generic_method_attribute_filter</strong> (<em>Callable</em><em>[</em><em>[</em><em>str</em><em>]</em><em>, </em><em>bool</em><em>]</em>)</p></li> |
| </ul> |
| </dd> |
| </dl> |
| <dl class="py method"> |
| <dt class="sig sig-object py" id="grpc_observability.OpenTelemetryPlugin.deregister_global"> |
| <span class="sig-name descname"><span class="pre">deregister_global</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc_observability/_open_telemetry_plugin.html#OpenTelemetryPlugin.deregister_global"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#grpc_observability.OpenTelemetryPlugin.deregister_global" title="Link to this definition">¶</a></dt> |
| <dd><p>De-register the global plugin that acts on all channels and servers running on the process.</p> |
| <dl class="field-list simple"> |
| <dt class="field-odd">Raises<span class="colon">:</span></dt> |
| <dd class="field-odd"><p><strong>RuntimeError</strong> – If no global plugin was registered.</p> |
| </dd> |
| <dt class="field-even">Return type<span class="colon">:</span></dt> |
| <dd class="field-even"><p>None</p> |
| </dd> |
| </dl> |
| </dd></dl> |
| |
| <dl class="py method"> |
| <dt class="sig sig-object py" id="grpc_observability.OpenTelemetryPlugin.register_global"> |
| <span class="sig-name descname"><span class="pre">register_global</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="reference internal" href="_modules/grpc_observability/_open_telemetry_plugin.html#OpenTelemetryPlugin.register_global"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#grpc_observability.OpenTelemetryPlugin.register_global" title="Link to this definition">¶</a></dt> |
| <dd><p>Registers a global plugin that acts on all channels and servers running on the process.</p> |
| <dl class="field-list simple"> |
| <dt class="field-odd">Raises<span class="colon">:</span></dt> |
| <dd class="field-odd"><p><strong>RuntimeError</strong> – If a global plugin was already registered.</p> |
| </dd> |
| <dt class="field-even">Return type<span class="colon">:</span></dt> |
| <dd class="field-even"><p>None</p> |
| </dd> |
| </dl> |
| </dd></dl> |
| |
| </dd></dl> |
| |
| </section> |
| </section> |
| |
| |
| </div> |
| |
| </div> |
| </div> |
| <div class="clearer"></div> |
| </div> |
| <div class="footer"> |
| ©2025, The gRPC Authors. |
| |
| | |
| <a href="_sources/grpc_observability.rst.txt" |
| rel="nofollow">Page source</a> |
| </div> |
| |
| |
| |
| |
| <script> |
| |
| var _gaq = _gaq || []; |
| _gaq.push(['_setAccount', 'UA-60127042-1']); |
| _gaq.push(['_setDomainName', 'none']); |
| _gaq.push(['_setAllowLinker', true]); |
| _gaq.push(['_trackPageview']); |
| |
| (function() { |
| var ga = document.createElement('script'); ga.async = true; |
| ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'https://www') + '.google-analytics.com/ga.js'; |
| var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s); |
| })(); |
| |
| </script> |
| |
| </body> |
| </html> |
