OpencensusTracer (gax 1.38.0 API)

java.lang.Object
- com.google.api.gax.tracing.OpencensusTracer

All Implemented Interfaces:

ApiTracer
```
@BetaApi(value="Surface for tracing is not yet stable")
public class OpencensusTracer
extends Object
implements ApiTracer
```
Implementation of ApiTracer that uses OpenCensus.
This implementation wraps an OpenCensus Span for every tracer and annotates that Span with various events throughout the lifecycle of the logical operation.
Each span will be named ClientName.MethodName and will have the following attributes:

attempt count
The Number of attempts sent before the logical operation completed
status
The status code of the last attempt
total response count
The number of messages received across all of the attempts. This will only be set for server streaming and bidi RPCs.
total request count
The number of messages sent across all of the attempts. This will only be set for client streaming and bidi RPCs.
batch count
For batch requests, the number of elements in the request.
batch size
For batch requests, the byte size of the request.

The spans will contain the following annotations:
- Connection selected with the following attributes:
  
  id
  The id of the connection in the local connection pool
- Attempt started with the following attributes:
  
  attempt
  Zero based sequential attempt number
- Attempt cancelled with the following attributes:
  
  attempt
  Zero based sequential attempt number
  attempt request count
  The number of requests sent in this attempt. This will only be set for client streaming and bidi RPCs.
  attempt response count
  The number of responses received in this attempt. This will only be set for server streaming and bidi RPCs.
- Attempt failed, scheduling next attempt with the following attributes:
  
  attempt
  Zero based sequential attempt number
  status
  The status code of the failed attempt
  delay
  The number of milliseconds to wait before trying again
  attempt request count
  The number of requests sent in this attempt. This will only be set for client streaming and bidi RPCs.
  attempt response count
  The number of responses received in this attempt. This will only be set for server streaming and bidi RPCs.
- Attempts exhausted with the following attributes:
  
  attempt
  Zero based sequential attempt number
  status
  The status code of the failed attempt
  attempt request count
  The number of requests sent in this attempt. This will only be set for client streaming and bidi RPCs.
  attempt response count
  The number of responses received in this attempt. This will only be set for server streaming and bidi RPCs.
- Attempt failed, error not retryable with the following attributes:
  
  attempt
  Zero based sequential attempt number
  status
  The status code of the failed attempt
  attempt request count
  The number of requests sent in this attempt. This will only be set for client streaming and bidi RPCs.
  attempt response count
  The number of responses received in this attempt. This will only be set for server streaming and bidi RPCs.
- Attempt succeeded with the following attributes:
  
  attempt
  Zero based sequential attempt number
  attempt request count
  The number of requests sent in this attempt. This will only be set for client streaming and bidi RPCs.
  attempt response count
  The number of responses received in this attempt. This will only be set for server streaming and bidi RPCs.
This class is thread compatible. It expects callers to follow grpc's threading model: there is only one thread that invokes the operation* and attempt* methods. Please see ApiStreamObserver for more information.

Nested Class Summary
- Nested classes/interfaces inherited from interface com.google.api.gax.tracing.ApiTracer
  ApiTracer.Scope

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`void`	`attemptCancelled()` Add an annotation that the attempt was cancelled by the user.
`void`	`attemptFailed(Throwable error, org.threeten.bp.Duration delay)` Adds an annotation that the attempt failed, but another attempt will be made after the delay.
`void`	`attemptFailedRetriesExhausted(Throwable error)` Adds an annotation that the attempt failed and that no further attempts will be made because retry limits have been reached.
`void`	`attemptPermanentFailure(Throwable error)` Adds an annotation that the attempt failed and that no further attempts will be made because the last error was not retryable.
`void`	`attemptStarted(int attemptNumber)` Adds an annotation that an attempt is about to start.
`void`	`attemptSucceeded()` Adds an annotation that the attempt succeeded.
`void`	`batchRequestSent(long elementCount, long requestSize)` Adds an annotation that a batch of writes has been flushed.
`void`	`connectionSelected(int id)` Annotates the operation with selected connection id from the `ChannelPool`.
`ApiTracer.Scope`	`inScope()` Asks the underlying implementation to install itself as a thread local.
`void`	`operationCancelled()` Signals that the operation was cancelled by the user.
`void`	`operationFailed(Throwable error)` Signals that the overall operation has failed and no further attempts will be made.
`void`	`operationSucceeded()` Signals that the overall operation has finished successfully.
`void`	`requestSent()` Adds an annotation that a streaming request has been sent.
`void`	`responseReceived()` Adds an annotation that a streaming response has been received.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Method Detail
  - inScope
```
public ApiTracer.Scope inScope()
```
    Asks the underlying implementation to install itself as a thread local. This allows for interop between clients using gax and external resources to share the same implementation of the tracing. For example OpenCensus will install a thread local that can read by the GRPC.
    
    Specified by:
    
    inScope in interface ApiTracer
  - operationSucceeded
```
public void operationSucceeded()
```
    Signals that the overall operation has finished successfully. The tracer is now considered closed and should no longer be used.
    
    Specified by:
    
    operationSucceeded in interface ApiTracer
  - operationCancelled
```
public void operationCancelled()
```
    Signals that the operation was cancelled by the user. The tracer is now considered closed and should no longer be used.
    
    Specified by:
    
    operationCancelled in interface ApiTracer
  - operationFailed
```
public void operationFailed(Throwable error)
```
    Signals that the overall operation has failed and no further attempts will be made. The tracer is now considered closed and should no longer be used.
    
    Specified by:
    
    operationFailed in interface ApiTracer
    
    Parameters:
    
    error - the final error that caused the operation to fail.
  - connectionSelected
```
public void connectionSelected(int id)
```
    Annotates the operation with selected connection id from the ChannelPool.
    
    Specified by:
    
    connectionSelected in interface ApiTracer
    
    Parameters:
    
    id - the local connection identifier of the selected connection.
  - attemptStarted
```
public void attemptStarted(int attemptNumber)
```
    Adds an annotation that an attempt is about to start. In general this should occur at the very start of the operation. The attemptNumber is zero based. So the initial attempt will be 0.
    
    Specified by:
    
    attemptStarted in interface ApiTracer
    
    Parameters:
    
    attemptNumber - the zero based sequential attempt number.
  - attemptSucceeded
```
public void attemptSucceeded()
```
    Adds an annotation that the attempt succeeded.
    
    Specified by:
    
    attemptSucceeded in interface ApiTracer
  - attemptCancelled
```
public void attemptCancelled()
```
    Description copied from interface: ApiTracer
    
    Add an annotation that the attempt was cancelled by the user.
    
    Specified by:
    
    attemptCancelled in interface ApiTracer
  - attemptFailed
```
public void attemptFailed(Throwable error,
                          org.threeten.bp.Duration delay)
```
    Adds an annotation that the attempt failed, but another attempt will be made after the delay.
    
    Specified by:
    
    attemptFailed in interface ApiTracer
    
    Parameters:
    
    error - the transient error that caused the attempt to fail.
    
    delay - the amount of time to wait before the next attempt will start.
  - attemptFailedRetriesExhausted
```
public void attemptFailedRetriesExhausted(Throwable error)
```
    Adds an annotation that the attempt failed and that no further attempts will be made because retry limits have been reached.
    
    Specified by:
    
    attemptFailedRetriesExhausted in interface ApiTracer
    
    Parameters:
    
    error - the last error received before retries were exhausted.
  - attemptPermanentFailure
```
public void attemptPermanentFailure(Throwable error)
```
    Adds an annotation that the attempt failed and that no further attempts will be made because the last error was not retryable.
    
    Specified by:
    
    attemptPermanentFailure in interface ApiTracer
    
    Parameters:
    
    error - the error that caused the final attempt to fail.
  - responseReceived
```
public void responseReceived()
```
    Adds an annotation that a streaming response has been received.
    
    Specified by:
    
    responseReceived in interface ApiTracer
  - requestSent
```
public void requestSent()
```
    Adds an annotation that a streaming request has been sent.
    
    Specified by:
    
    requestSent in interface ApiTracer
  - batchRequestSent
```
public void batchRequestSent(long elementCount,
                             long requestSize)
```
    Adds an annotation that a batch of writes has been flushed.
    
    Specified by:
    
    batchRequestSent in interface ApiTracer
    
    Parameters:
    
    elementCount - the number of elements in the batch.
    
    requestSize - the size of the batch in bytes.

Class OpencensusTracer

Nested Class Summary

Nested classes/interfaces inherited from interface com.google.api.gax.tracing.ApiTracer

Method Summary

Methods inherited from class java.lang.Object

Method Detail

inScope

operationSucceeded

operationCancelled

operationFailed

connectionSelected

attemptStarted

attemptSucceeded

attemptCancelled

attemptFailed

attemptFailedRetriesExhausted

attemptPermanentFailure

responseReceived

requestSent

batchRequestSent