Trace (Hawkular APM::API 0.13.0.Final API)

java.lang.Object
- org.hawkular.apm.api.model.trace.Trace

```
public class Trace
extends Object
```
This class represents the top level trace instance description. This model can be used to represent either a fragment of a trace instance, captured from one of multiple resources executing the transaction, or a complete end to end correlated description of the flow.

Author:

gbrown

Constructor Summary

Constructors
Constructor and Description

Trace()

Constructors
Constructor and Description
`Trace()`

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`Set<Property>`	`allProperties()` This method returns all properties contained in the node hierarchy that can be used to search for the trace.
`long`	`calculateDuration()` This method returns the duration of the trace fragment.
`long`	`endTime()` This method returns the end time of the trace fragment.
`boolean`	`equals(Object obj)`
`Set<Node>`	`getCorrelatedNodes(CorrelationIdentifier cid)` This method locates any node within the trace that is associated with the supplied correlation id.
`String`	`getFragmentId()`
`String`	`getHostAddress()`
`String`	`getHostName()`
`List<Node>`	`getNodes()`
`Set<Property>`	`getProperties(String name)` This method returns the set of properties having the supplied property name.
`long`	`getTimestamp()`
`String`	`getTraceId()`
`String`	`getTransaction()`
`int`	`hashCode()`
`boolean`	`hasProperty(String name)` This method determines whether there is atleast one property with the supplied name.
`boolean`	`initialFragment()` This method determines whether this trace is the initial fragment of an instance.
`Trace`	`setFragmentId(String fragmentId)` This method sets the fragment id.
`Trace`	`setHostAddress(String hostAddress)`
`Trace`	`setHostName(String hostName)`
`Trace`	`setNodes(List<Node> nodes)`
`Trace`	`setTimestamp(long timestamp)`
`Trace`	`setTraceId(String traceId)` This method sets the trace id.
`Trace`	`setTransaction(String name)`
`String`	`toString()`

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

- Constructor Detail
  - Trace
```
public Trace()
```
- Method Detail
  - getTraceId
```
public String getTraceId()
```
    Returns:
    
    the traceId
  - setTraceId
```
public Trace setTraceId(String traceId)
```
    This method sets the trace id. When the fragment and trace id are the same value, it means the fragment is the initial fragment for the trace instance.
    
    Parameters:
    
    traceId - the traceId to set
    
    Returns:
    
    The trace
  - getFragmentId
```
public String getFragmentId()
```
    Returns:
    
    the fragmentId
  - setFragmentId
```
public Trace setFragmentId(String fragmentId)
```
    This method sets the fragment id. When the fragment and trace id are the same value, it means the fragment is the initial fragment for the trace instance.
    
    Parameters:
    
    fragmentId - the fragmentId to set
    
    Returns:
    
    The trace
  - getTimestamp
```
public long getTimestamp()
```
    Returns:
    
    the timestamp in microseconds
  - setTimestamp
```
public Trace setTimestamp(long timestamp)
```
    Parameters:
    
    timestamp - the timestamp in microseconds
    
    Returns:
    
    The trace
  - getTransaction
```
public String getTransaction()
```
    Returns:
    
    the transaction name
  - setTransaction
```
public Trace setTransaction(String name)
```
    Parameters:
    
    name - the transaction name to set
    
    Returns:
    
    The trace
  - getHostName
```
public String getHostName()
```
    Returns:
    
    the host name
  - setHostName
```
public Trace setHostName(String hostName)
```
    Parameters:
    
    hostName - the host name to set
    
    Returns:
    
    The trace
  - getHostAddress
```
public String getHostAddress()
```
    Returns:
    
    the host address
  - setHostAddress
```
public Trace setHostAddress(String hostAddress)
```
    Parameters:
    
    hostAddress - the host address to set
    
    Returns:
    
    The trace
  - getNodes
```
public List<Node> getNodes()
```
    Returns:
    
    the nodes
  - setNodes
```
public Trace setNodes(List<Node> nodes)
```
    Parameters:
    
    nodes - the nodes to set
    
    Returns:
    
    The trace
  - allProperties
```
public Set<Property> allProperties()
```
    This method returns all properties contained in the node hierarchy that can be used to search for the trace.
    
    Returns:
    
    Aggregated list of all the properties in the node hierarchy
  - hasProperty
```
public boolean hasProperty(String name)
```
    This method determines whether there is atleast one property with the supplied name.
    
    Parameters:
    
    name - The property name
    
    Returns:
    
    Whether a property of the supplied name is defined
  - getProperties
```
public Set<Property> getProperties(String name)
```
    This method returns the set of properties having the supplied property name.
    
    Parameters:
    
    name - The property name
    
    Returns:
    
    The set of properties with the supplied name
  - initialFragment
```
public boolean initialFragment()
```
    This method determines whether this trace is the initial fragment of an instance.
    
    Returns:
    
    Whether this is the initial fragment
  - endTime
```
public long endTime()
```
    This method returns the end time of the trace fragment.
    
    Returns:
    
    The end time (in microseconds)
  - calculateDuration
```
public long calculateDuration()
```
    This method returns the duration of the trace fragment.
    
    Returns:
    
    The duration (in microseconds), or 0 if no nodes defined
  - getCorrelatedNodes
```
public Set<Node> getCorrelatedNodes(CorrelationIdentifier cid)
```
    This method locates any node within the trace that is associated with the supplied correlation id.
    
    Parameters:
    
    cid - The correlation identifier
    
    Returns:
    
    The nodes that were correlated with the supplied correlation identifier
  - hashCode
```
public int hashCode()
```
    Overrides:
    
    hashCode in class Object
  - equals
```
public boolean equals(Object obj)
```
    Overrides:
    
    equals in class Object
  - toString
```
public String toString()
```
    Overrides:
    
    toString in class Object

Class Trace

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

Trace

Method Detail

getTraceId

setTraceId

getFragmentId

setFragmentId

getTimestamp

setTimestamp

getTransaction

setTransaction

getHostName

setHostName

getHostAddress

setHostAddress

getNodes

setNodes

allProperties

hasProperty

getProperties

initialFragment

endTime

calculateDuration

getCorrelatedNodes

hashCode

equals

toString