The timestamp of the transaction. If the transaction timestamp is not provided (the default behaviour), it will be set by the apm-server (v6.3+). You can, however, set the timestamp on the client (using new Date().toISOString()), but you should be aware that the timestamp will reflect the client’s local time which might not always be accurate.

`transaction.startSpan([name][, type][, options])`

edit

var span = transaction.startSpan('My custom span')

Start and return a new custom span associated with this transaction.

Arguments:

name - The name of the span (string). Defaults to unnamed
type - The type of span (string). Defaults to custom
options - The following options are supported:
- parentId - Parent id associated with the new span. Defaults to current transaction id
- sync - Denotes if the span is blocking (sync) or non-blocking(async).

When a span is started it will measure the time until span.end() is called.

See Span API docs for details on how to use custom spans.

`transaction.addTags()`

edit

[4.1.x] Deprecated in 4.1.x. Tags have been replaced with labels , Please use transaction.addLabels() instead

`transaction.addLabels()`

edit

transaction.addLabels({ [name]: value })

Add several labels on the transaction. If an error happens during the transaction, it will also get tagged with the same labels.

Labels are key/value pairs that are indexed by Elasticsearch and therefore searchable (as opposed to data set via apm.setCustomContext()).

Before using custom labels, ensure you understand the different types of metadata that are available.

Arguments:

name - Any string. All periods (.), asterisks (*), and double quotation marks (") will be replaced by underscores (_), as those characters have special meaning in Elasticsearch
value - Any string. If a non-string data type is given, it’s converted to a string before being sent to the APM Server.

Avoid defining too many user-specified tags. Defining too many unique fields in an index is a condition that can lead to a mapping explosion.

`transaction.end()`

edit

transaction.end()

Ends the transaction. If the transaction has already ended, nothing happens.

`transaction.mark(key)`

edit

transaction.mark(key)

Marks the current point in time relative to the start of the transaction. Use this method to mark significant events that happen while the transaction is active.

Arguments:

key - Any string. All periods (.), asterisks (*), and double quotation marks (") will be replaced by underscores (_), as those characters have special meaning in Elasticsearch

« Agent API Span API »