grpc/python/grpc_observability.html

187 lines
10 KiB
HTML
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<!DOCTYPE html>
<html lang="en">
<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 &#8212; gRPC Python 1.64.0 documentation</title>
<link rel="stylesheet" type="text/css" href="_static/pygments.css?v=4f649999" />
<link rel="stylesheet" type="text/css" href="_static/alabaster.css?v=8090fdca" />
<script data-url_root="./" id="documentation_options" src="_static/documentation_options.js?v=057799ce"></script>
<script src="_static/doctools.js?v=888ff710"></script>
<script src="_static/sphinx_highlight.js?v=4825356b"></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" />
<meta name="viewport" content="width=device-width, initial-scale=0.9, maximum-scale=0.9" />
</head><body>
<div class="document">
<div class="sphinxsidebar" role="navigation" aria-label="main navigation">
<div class="sphinxsidebarwrapper">
<h1 class="logo"><a href="index.html">gRPC Python</a></h1>
<p class="blurb">1.64.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>
<div 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>
</div>
<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="Permalink 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="Permalink 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">[]</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="Permalink 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="Permalink 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="Permalink 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">
&copy;2020, The gRPC Authors.
|
<a href="_sources/grpc_observability.rst.txt"
rel="nofollow">Page source</a>
</div>
<script type="text/javascript">
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.type = 'text/javascript'; ga.async = true;
ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js';
var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s);
})();
</script>
</body>
</html>