Span lists are one of the core components in Kamon APM. You will often find them integrated into pages such as the JDBC dashboard, the trace search, or the analyze view. They will list spans that match certain criteria, as determined by the context they appear in, but all will share a few common features. Every span list will show the following:
|Span Result||Icon||Completed successfully or with error|
|Time||Datetime||When the span concluded|
|Duration||Duration||Duration of span and marker showing position in overall distribution of span durations in the list|
The span might also include one of two markers next to the duration, that indicate presence of errors:
The red X indicator shows the the span itself has an error (or, rather, an error occurred during the operation). The yellow exclamation mark indicates that while the operation itself did not experience an error, once of the operations it called (its descendant spans) did.
Every trace list is time sensitive, and will only show spans within the time period selected in the time picker. Some lists, however, will not automatically update to match live mode. You will recognize these lists by the presence of a refresh marker. In that case, the view will be frozen until either the time picker selection is manually changed, or the refresh button is clicked. In the latter case, the time will then be updated to match the current state of the sliding time window.
The span list also includes an error toggle. If turned on, only spans with errors (an error occurred during the execution of the operation) will be shown in the list.
Your first step towards Kamon APM is conversation with Kamon's lead developer, Ivan. He'll help you figure out if Kamon APM is the right tool for your team and personally guide you through the initial setup and next steps. Here he is: