blob: 145e0574b575e3aa8638764c75e5409faf55f6b7 [file] [log] [blame]
<!DOCTYPE HTML>
<!-- NewPage -->
<html lang="en">
<head>
<!-- Generated by javadoc -->
<title>StreamTracer (grpc-all 1.74.0 API)</title>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<link rel="stylesheet" type="text/css" href="../../stylesheet.css" title="Style">
<link rel="stylesheet" type="text/css" href="../../jquery/jquery-ui.min.css" title="Style">
<link rel="stylesheet" type="text/css" href="../../jquery-ui.overrides.css" title="Style">
<script type="text/javascript" src="../../script.js"></script>
<script type="text/javascript" src="../../jquery/jszip/dist/jszip.min.js"></script>
<script type="text/javascript" src="../../jquery/jszip-utils/dist/jszip-utils.min.js"></script>
<!--[if IE]>
<script type="text/javascript" src="../../jquery/jszip-utils/dist/jszip-utils-ie.min.js"></script>
<![endif]-->
<script type="text/javascript" src="../../jquery/jquery-3.7.1.min.js"></script>
<script type="text/javascript" src="../../jquery/jquery-ui.min.js"></script>
</head>
<body>
<script type="text/javascript"><!--
try {
if (location.href.indexOf('is-external=true') == -1) {
parent.document.title="StreamTracer (grpc-all 1.74.0 API)";
}
}
catch(err) {
}
//-->
var data = {"i0":10,"i1":10,"i2":10,"i3":10,"i4":10,"i5":10,"i6":10,"i7":10,"i8":10};
var tabs = {65535:["t0","All Methods"],2:["t2","Instance Methods"],8:["t4","Concrete Methods"]};
var altColor = "altColor";
var rowColor = "rowColor";
var tableTab = "tableTab";
var activeTableTab = "activeTableTab";
var pathtoroot = "../../";
var useModuleDirectories = true;
loadScripts(document, 'script');</script>
<noscript>
<div>JavaScript is disabled on your browser.</div>
</noscript>
<header role="banner">
<nav role="navigation">
<div class="fixedNav">
<!-- ========= START OF TOP NAVBAR ======= -->
<div class="topNav"><a id="navbar.top">
<!-- -->
</a>
<div class="skipNav"><a href="#skip.navbar.top" title="Skip navigation links">Skip navigation links</a></div>
<a id="navbar.top.firstrow">
<!-- -->
</a>
<ul class="navList" title="Navigation">
<li><a href="../../index.html">Overview</a></li>
<li><a href="package-summary.html">Package</a></li>
<li class="navBarCell1Rev">Class</li>
<li><a href="class-use/StreamTracer.html">Use</a></li>
<li><a href="package-tree.html">Tree</a></li>
<li><a href="../../deprecated-list.html">Deprecated</a></li>
<li><a href="../../index-all.html">Index</a></li>
<li><a href="../../help-doc.html">Help</a></li>
</ul>
</div>
<div class="subNav">
<ul class="navList" id="allclasses_navbar_top">
<li><a href="../../allclasses.html">All&nbsp;Classes</a></li>
</ul>
<ul class="navListSearch">
<li><label for="search">SEARCH:</label>
<input type="text" id="search" value="search" disabled="disabled">
<input type="reset" id="reset" value="reset" disabled="disabled">
</li>
</ul>
<div>
<script type="text/javascript"><!--
allClassesLink = document.getElementById("allclasses_navbar_top");
if(window==top) {
allClassesLink.style.display = "block";
}
else {
allClassesLink.style.display = "none";
}
//-->
</script>
<noscript>
<div>JavaScript is disabled on your browser.</div>
</noscript>
</div>
<div>
<ul class="subNavList">
<li>Summary:&nbsp;</li>
<li>Nested&nbsp;|&nbsp;</li>
<li>Field&nbsp;|&nbsp;</li>
<li><a href="#constructor.summary">Constr</a>&nbsp;|&nbsp;</li>
<li><a href="#method.summary">Method</a></li>
</ul>
<ul class="subNavList">
<li>Detail:&nbsp;</li>
<li>Field&nbsp;|&nbsp;</li>
<li><a href="#constructor.detail">Constr</a>&nbsp;|&nbsp;</li>
<li><a href="#method.detail">Method</a></li>
</ul>
</div>
<a id="skip.navbar.top">
<!-- -->
</a></div>
<!-- ========= END OF TOP NAVBAR ========= -->
</div>
<div class="navPadding">&nbsp;</div>
<script type="text/javascript"><!--
$('.navPadding').css('padding-top', $('.fixedNav').css("height"));
//-->
</script>
</nav>
</header>
<!-- ======== START OF CLASS DATA ======== -->
<main role="main">
<div class="header">
<div class="subTitle"><span class="packageLabelInType">Package</span>&nbsp;<a href="package-summary.html">io.grpc</a></div>
<h2 title="Class StreamTracer" class="title">Class StreamTracer</h2>
</div>
<div class="contentContainer">
<ul class="inheritance">
<li><a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang" class="externalLink">java.lang.Object</a></li>
<li>
<ul class="inheritance">
<li>io.grpc.StreamTracer</li>
</ul>
</li>
</ul>
<div class="description">
<ul class="blockList">
<li class="blockList">
<dl>
<dt>Direct Known Subclasses:</dt>
<dd><code><a href="ClientStreamTracer.html" title="class in io.grpc">ClientStreamTracer</a></code>, <code><a href="ServerStreamTracer.html" title="class in io.grpc">ServerStreamTracer</a></code></dd>
</dl>
<hr>
<pre><a href="ExperimentalApi.html" title="annotation in io.grpc">@ExperimentalApi</a>("https://github.com/grpc/grpc-java/issues/2861")
@ThreadSafe
public abstract class <span class="typeNameLabel">StreamTracer</span>
extends <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang" class="externalLink">Object</a></pre>
<div class="block">Listens to events on a stream to collect metrics.
<p>DO NOT MOCK: Use TestStreamTracer. Mocks are not thread-safe</div>
</li>
</ul>
</div>
<div class="summary">
<ul class="blockList">
<li class="blockList">
<!-- ======== CONSTRUCTOR SUMMARY ======== -->
<section>
<ul class="blockList">
<li class="blockList"><a id="constructor.summary">
<!-- -->
</a>
<h3>Constructor Summary</h3>
<table class="memberSummary">
<caption><span>Constructors</span><span class="tabEnd">&nbsp;</span></caption>
<tr>
<th class="colFirst" scope="col">Constructor</th>
<th class="colLast" scope="col">Description</th>
</tr>
<tr class="altColor">
<th class="colConstructorName" scope="row"><code><span class="memberNameLink"><a href="#%3Cinit%3E()">StreamTracer</a></span>()</code></th>
<td class="colLast">&nbsp;</td>
</tr>
</table>
</li>
</ul>
</section>
<!-- ========== METHOD SUMMARY =========== -->
<section>
<ul class="blockList">
<li class="blockList"><a id="method.summary">
<!-- -->
</a>
<h3>Method Summary</h3>
<table class="memberSummary">
<caption><span id="t0" class="activeTableTab"><span>All Methods</span><span class="tabEnd">&nbsp;</span></span><span id="t2" class="tableTab"><span><a href="javascript:show(2);">Instance Methods</a></span><span class="tabEnd">&nbsp;</span></span><span id="t4" class="tableTab"><span><a href="javascript:show(8);">Concrete Methods</a></span><span class="tabEnd">&nbsp;</span></span></caption>
<tr>
<th class="colFirst" scope="col">Modifier and Type</th>
<th class="colSecond" scope="col">Method</th>
<th class="colLast" scope="col">Description</th>
</tr>
<tr id="i0" class="altColor">
<td class="colFirst"><code>void</code></td>
<th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#inboundMessage(int)">inboundMessage</a></span>&#8203;(int&nbsp;seqNo)</code></th>
<td class="colLast">
<div class="block">An inbound message has been received by the stream.</div>
</td>
</tr>
<tr id="i1" class="rowColor">
<td class="colFirst"><code>void</code></td>
<th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#inboundMessageRead(int,long,long)">inboundMessageRead</a></span>&#8203;(int&nbsp;seqNo,
long&nbsp;optionalWireSize,
long&nbsp;optionalUncompressedSize)</code></th>
<td class="colLast">
<div class="block">An inbound message has been fully read from the transport.</div>
</td>
</tr>
<tr id="i2" class="altColor">
<td class="colFirst"><code>void</code></td>
<th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#inboundUncompressedSize(long)">inboundUncompressedSize</a></span>&#8203;(long&nbsp;bytes)</code></th>
<td class="colLast">
<div class="block">The uncompressed size of some inbound data is revealed.</div>
</td>
</tr>
<tr id="i3" class="rowColor">
<td class="colFirst"><code>void</code></td>
<th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#inboundWireSize(long)">inboundWireSize</a></span>&#8203;(long&nbsp;bytes)</code></th>
<td class="colLast">
<div class="block">The wire size of some inbound data is revealed.</div>
</td>
</tr>
<tr id="i4" class="altColor">
<td class="colFirst"><code>void</code></td>
<th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#outboundMessage(int)">outboundMessage</a></span>&#8203;(int&nbsp;seqNo)</code></th>
<td class="colLast">
<div class="block">An outbound message has been passed to the stream.</div>
</td>
</tr>
<tr id="i5" class="rowColor">
<td class="colFirst"><code>void</code></td>
<th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#outboundMessageSent(int,long,long)">outboundMessageSent</a></span>&#8203;(int&nbsp;seqNo,
long&nbsp;optionalWireSize,
long&nbsp;optionalUncompressedSize)</code></th>
<td class="colLast">
<div class="block">An outbound message has been serialized and sent to the transport.</div>
</td>
</tr>
<tr id="i6" class="altColor">
<td class="colFirst"><code>void</code></td>
<th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#outboundUncompressedSize(long)">outboundUncompressedSize</a></span>&#8203;(long&nbsp;bytes)</code></th>
<td class="colLast">
<div class="block">The uncompressed size of some outbound data is revealed.</div>
</td>
</tr>
<tr id="i7" class="rowColor">
<td class="colFirst"><code>void</code></td>
<th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#outboundWireSize(long)">outboundWireSize</a></span>&#8203;(long&nbsp;bytes)</code></th>
<td class="colLast">
<div class="block">The wire size of some outbound data is revealed.</div>
</td>
</tr>
<tr id="i8" class="altColor">
<td class="colFirst"><code>void</code></td>
<th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#streamClosed(io.grpc.Status)">streamClosed</a></span>&#8203;(<a href="Status.html" title="class in io.grpc">Status</a>&nbsp;status)</code></th>
<td class="colLast">
<div class="block">Stream is closed.</div>
</td>
</tr>
</table>
<ul class="blockList">
<li class="blockList"><a id="methods.inherited.from.class.java.lang.Object">
<!-- -->
</a>
<h3>Methods inherited from class&nbsp;java.lang.<a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang" class="externalLink">Object</a></h3>
<code><a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true#clone--" title="class or interface in java.lang" class="externalLink">clone</a>, <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true#equals-java.lang.Object-" title="class or interface in java.lang" class="externalLink">equals</a>, <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true#finalize--" title="class or interface in java.lang" class="externalLink">finalize</a>, <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true#getClass--" title="class or interface in java.lang" class="externalLink">getClass</a>, <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true#hashCode--" title="class or interface in java.lang" class="externalLink">hashCode</a>, <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true#notify--" title="class or interface in java.lang" class="externalLink">notify</a>, <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true#notifyAll--" title="class or interface in java.lang" class="externalLink">notifyAll</a>, <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true#toString--" title="class or interface in java.lang" class="externalLink">toString</a>, <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true#wait--" title="class or interface in java.lang" class="externalLink">wait</a>, <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true#wait-long-" title="class or interface in java.lang" class="externalLink">wait</a>, <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true#wait-long-int-" title="class or interface in java.lang" class="externalLink">wait</a></code></li>
</ul>
</li>
</ul>
</section>
</li>
</ul>
</div>
<div class="details">
<ul class="blockList">
<li class="blockList">
<!-- ========= CONSTRUCTOR DETAIL ======== -->
<section>
<ul class="blockList">
<li class="blockList"><a id="constructor.detail">
<!-- -->
</a>
<h3>Constructor Detail</h3>
<a id="&lt;init&gt;()">
<!-- -->
</a>
<ul class="blockListLast">
<li class="blockList">
<h4>StreamTracer</h4>
<pre>public&nbsp;StreamTracer()</pre>
</li>
</ul>
</li>
</ul>
</section>
<!-- ============ METHOD DETAIL ========== -->
<section>
<ul class="blockList">
<li class="blockList"><a id="method.detail">
<!-- -->
</a>
<h3>Method Detail</h3>
<a id="streamClosed(io.grpc.Status)">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>streamClosed</h4>
<pre class="methodSignature">public&nbsp;void&nbsp;streamClosed&#8203;(<a href="Status.html" title="class in io.grpc">Status</a>&nbsp;status)</pre>
<div class="block">Stream is closed. This will be called exactly once.</div>
</li>
</ul>
<a id="outboundMessage(int)">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>outboundMessage</h4>
<pre class="methodSignature">public&nbsp;void&nbsp;outboundMessage&#8203;(int&nbsp;seqNo)</pre>
<div class="block">An outbound message has been passed to the stream. This is called as soon as the stream knows
about the message, but doesn't have further guarantee such as whether the message is serialized
or not.</div>
<dl>
<dt><span class="paramLabel">Parameters:</span></dt>
<dd><code>seqNo</code> - the sequential number of the message within the stream, starting from 0. It can
be used to correlate with <a href="#outboundMessageSent(int,long,long)"><code>outboundMessageSent(int, long, long)</code></a> for the same message.</dd>
</dl>
</li>
</ul>
<a id="inboundMessage(int)">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>inboundMessage</h4>
<pre class="methodSignature">public&nbsp;void&nbsp;inboundMessage&#8203;(int&nbsp;seqNo)</pre>
<div class="block">An inbound message has been received by the stream. This is called as soon as the stream knows
about the message, but doesn't have further guarantee such as whether the message is
deserialized or not.</div>
<dl>
<dt><span class="paramLabel">Parameters:</span></dt>
<dd><code>seqNo</code> - the sequential number of the message within the stream, starting from 0. It can
be used to correlate with <a href="#inboundMessageRead(int,long,long)"><code>inboundMessageRead(int, long, long)</code></a> for the same message.</dd>
</dl>
</li>
</ul>
<a id="outboundMessageSent(int,long,long)">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>outboundMessageSent</h4>
<pre class="methodSignature">public&nbsp;void&nbsp;outboundMessageSent&#8203;(int&nbsp;seqNo,
long&nbsp;optionalWireSize,
long&nbsp;optionalUncompressedSize)</pre>
<div class="block">An outbound message has been serialized and sent to the transport.</div>
<dl>
<dt><span class="paramLabel">Parameters:</span></dt>
<dd><code>seqNo</code> - the sequential number of the message within the stream, starting from 0. It can
be used to correlate with <a href="#outboundMessage(int)"><code>outboundMessage(int)</code></a> for the same message.</dd>
<dd><code>optionalWireSize</code> - the wire size of the message. -1 if unknown</dd>
<dd><code>optionalUncompressedSize</code> - the uncompressed serialized size of the message. -1 if unknown</dd>
</dl>
</li>
</ul>
<a id="inboundMessageRead(int,long,long)">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>inboundMessageRead</h4>
<pre class="methodSignature">public&nbsp;void&nbsp;inboundMessageRead&#8203;(int&nbsp;seqNo,
long&nbsp;optionalWireSize,
long&nbsp;optionalUncompressedSize)</pre>
<div class="block">An inbound message has been fully read from the transport.</div>
<dl>
<dt><span class="paramLabel">Parameters:</span></dt>
<dd><code>seqNo</code> - the sequential number of the message within the stream, starting from 0. It can
be used to correlate with <a href="#inboundMessage(int)"><code>inboundMessage(int)</code></a> for the same message.</dd>
<dd><code>optionalWireSize</code> - the wire size of the message. -1 if unknown</dd>
<dd><code>optionalUncompressedSize</code> - the uncompressed serialized size of the message. -1 if unknown</dd>
</dl>
</li>
</ul>
<a id="outboundWireSize(long)">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>outboundWireSize</h4>
<pre class="methodSignature">public&nbsp;void&nbsp;outboundWireSize&#8203;(long&nbsp;bytes)</pre>
<div class="block">The wire size of some outbound data is revealed. This can only used to record the accumulative
outbound wire size. There is no guarantee wrt timing or granularity of this method.</div>
</li>
</ul>
<a id="outboundUncompressedSize(long)">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>outboundUncompressedSize</h4>
<pre class="methodSignature">public&nbsp;void&nbsp;outboundUncompressedSize&#8203;(long&nbsp;bytes)</pre>
<div class="block">The uncompressed size of some outbound data is revealed. This can only used to record the
accumulative outbound uncompressed size. There is no guarantee wrt timing or granularity of
this method.</div>
</li>
</ul>
<a id="inboundWireSize(long)">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>inboundWireSize</h4>
<pre class="methodSignature">public&nbsp;void&nbsp;inboundWireSize&#8203;(long&nbsp;bytes)</pre>
<div class="block">The wire size of some inbound data is revealed. This can only be used to record the
accumulative received wire size. There is no guarantee wrt timing or granularity of this
method.</div>
</li>
</ul>
<a id="inboundUncompressedSize(long)">
<!-- -->
</a>
<ul class="blockListLast">
<li class="blockList">
<h4>inboundUncompressedSize</h4>
<pre class="methodSignature">public&nbsp;void&nbsp;inboundUncompressedSize&#8203;(long&nbsp;bytes)</pre>
<div class="block">The uncompressed size of some inbound data is revealed. This can only used to record the
accumulative received uncompressed size. There is no guarantee wrt timing or granularity of
this method.</div>
</li>
</ul>
</li>
</ul>
</section>
</li>
</ul>
</div>
</div>
</main>
<!-- ========= END OF CLASS DATA ========= -->
<footer role="contentinfo">
<nav role="navigation">
<!-- ======= START OF BOTTOM NAVBAR ====== -->
<div class="bottomNav"><a id="navbar.bottom">
<!-- -->
</a>
<div class="skipNav"><a href="#skip.navbar.bottom" title="Skip navigation links">Skip navigation links</a></div>
<a id="navbar.bottom.firstrow">
<!-- -->
</a>
<ul class="navList" title="Navigation">
<li><a href="../../index.html">Overview</a></li>
<li><a href="package-summary.html">Package</a></li>
<li class="navBarCell1Rev">Class</li>
<li><a href="class-use/StreamTracer.html">Use</a></li>
<li><a href="package-tree.html">Tree</a></li>
<li><a href="../../deprecated-list.html">Deprecated</a></li>
<li><a href="../../index-all.html">Index</a></li>
<li><a href="../../help-doc.html">Help</a></li>
</ul>
</div>
<div class="subNav">
<ul class="navList" id="allclasses_navbar_bottom">
<li><a href="../../allclasses.html">All&nbsp;Classes</a></li>
</ul>
<div>
<script type="text/javascript"><!--
allClassesLink = document.getElementById("allclasses_navbar_bottom");
if(window==top) {
allClassesLink.style.display = "block";
}
else {
allClassesLink.style.display = "none";
}
//-->
</script>
<noscript>
<div>JavaScript is disabled on your browser.</div>
</noscript>
</div>
<div>
<ul class="subNavList">
<li>Summary:&nbsp;</li>
<li>Nested&nbsp;|&nbsp;</li>
<li>Field&nbsp;|&nbsp;</li>
<li><a href="#constructor.summary">Constr</a>&nbsp;|&nbsp;</li>
<li><a href="#method.summary">Method</a></li>
</ul>
<ul class="subNavList">
<li>Detail:&nbsp;</li>
<li>Field&nbsp;|&nbsp;</li>
<li><a href="#constructor.detail">Constr</a>&nbsp;|&nbsp;</li>
<li><a href="#method.detail">Method</a></li>
</ul>
</div>
<a id="skip.navbar.bottom">
<!-- -->
</a></div>
<!-- ======== END OF BOTTOM NAVBAR ======= -->
</nav>
</footer>
</body>
</html>