Thousand Island v0.6.4

View Source ThousandIsland.Telemetry (Thousand Island v0.6.4)

The following telemetry spans are emitted by thousand_island

thousand_island-listener

 [:thousand_island, :listener, *]

Represents a Thousand Island server listening to a port

This span is started by the following event:

  • [:thousand_island, :listener, :start]

    Represents the start of the span

    This event contains the following measurements:

    • monotonic_time: The time of this event, in :native units

    This event contains the following metadata:

    • telemetry_span_context: A unique identifier for this span
    • local_address: The IP address that the listener is bound to
    • local_port: The port that the listener is bound to
    • transport_module: The transport module in use
    • transport_options: Options passed to the transport module at startup

This span is ended by the following event:

  • [:thousand_island, :listener, :stop]

    Represents the end of the span

    This event contains the following measurements:

    • monotonic_time: The time of this event, in :native units
    • duration: The span duration, in :native units

    This event contains the following metadata:

    • telemetry_span_context: A unique identifier for this span
    • local_address: The IP address that the listener is bound to
    • local_port: The port that the listener is bound to
    • transport_module: The transport module in use
    • transport_options: Options passed to the transport module at startup

thousand_island-acceptor

 [:thousand_island, :acceptor, *]

Represents a Thousand Island acceptor process listening for connections

This span is started by the following event:

  • [:thousand_island, :acceptor, :start]

    Represents the start of the span

    This event contains the following measurements:

    • monotonic_time: The time of this event, in :native units

    This event contains the following metadata:

    • telemetry_span_context: A unique identifier for this span
    • parent_telemetry_span_context: The span context of the :listener which created this acceptor

This span is ended by the following event:

  • [:thousand_island, :acceptor, :stop]

    Represents the end of the span

    This event contains the following measurements:

    • monotonic_time: The time of this event, in :native units
    • duration: The span duration, in :native units
    • connections: The number of client requests that the acceptor handled

    This event contains the following metadata:

    • telemetry_span_context: A unique identifier for this span
    • parent_telemetry_span_context: The span context of the :listener which created this acceptor
    • error: The error that caused the span to end, if it ended in error

thousand_island-connection

 [:thousand_island, :connection, *]

Represents Thousand Island handling a specific client request

This span is started by the following event:

  • [:thousand_island, :connection, :start]

    Represents the start of the span

    This event contains the following measurements:

    • monotonic_time: The time of this event, in :native units

    This event contains the following metadata:

    • telemetry_span_context: A unique identifier for this span
    • parent_telemetry_span_context: The span context of the :acceptor span which accepted this connection
    • remote_address: The IP address of the connected client
    • remote_port: The port of the connected client

This span is ended by the following event:

  • [:thousand_island, :connection, :stop]

    Represents the end of the span

    This event contains the following measurements:

    • monotonic_time: The time of this event, in :native units
    • duration: The span duration, in :native units
    • send_oct: The number of octets sent on the connection
    • send_cnt: The number of packets sent on the connection
    • recv_oct: The number of octets received on the connection
    • recv_cnt: The number of packets received on the connection

    This event contains the following metadata:

    • telemetry_span_context: A unique identifier for this span
    • parent_telemetry_span_context: The span context of the :acceptor span which accepted this connection
    • remote_address: The IP address of the connected client
    • remote_port: The port of the connected client
    • error: The error that caused the span to end, if it ended in error

The following events may be emitted within this span:

  • [:thousand_island, :connection, :ready]

    Thousand Island has completed setting up the client connection

    This event contains the following measurements:

    • monotonic_time: The time of this event, in :native units

    This event contains the following metadata:

    • telemetry_span_context: A unique identifier for this span

  • [:thousand_island, :connection, :async_recv]

    Thousand Island has asynchronously received data from the client

    This event contains the following measurements:

    • data: The data received from the client

    This event contains the following metadata:

    • telemetry_span_context: A unique identifier for this span

  • [:thousand_island, :connection, :recv]

    Thousand Island has synchronously received data from the client

    This event contains the following measurements:

    • data: The data received from the client

    This event contains the following metadata:

    • telemetry_span_context: A unique identifier for this span

  • [:thousand_island, :connection, :recv_error]

    Thousand Island encountered an error reading data from the client

    This event contains the following measurements:

    • error: A description of the error

    This event contains the following metadata:

    • telemetry_span_context: A unique identifier for this span

  • [:thousand_island, :connection, :send]

    Thousand Island has sent data to the client

    This event contains the following measurements:

    • data: The data sent to the client

    This event contains the following metadata:

    • telemetry_span_context: A unique identifier for this span

  • [:thousand_island, :connection, :send_error]

    Thousand Island encountered an error sending data to the client

    This event contains the following measurements:

    • data: The data that was being sent to the client
    • error: A description of the error

    This event contains the following metadata:

    • telemetry_span_context: A unique identifier for this span

  • [:thousand_island, :connection, :sendfile]

    Thousand Island has sent a file to the client

    This event contains the following measurements:

    • filename: The filename containing data sent to the client
    • offset: The offset (in bytes) within the file sending started from
    • bytes_written: The number of bytes written

    This event contains the following metadata:

    • telemetry_span_context: A unique identifier for this span

  • [:thousand_island, :connection, :sendfile_error]

    Thousand Island encountered an error sending a file to the client

    This event contains the following measurements:

    • filename: The filename containing data that was being sent to the client
    • offset: The offset (in bytes) within the file where sending started from
    • length: The number of bytes that were attempted to send
    • error: A description of the error

    This event contains the following metadata:

    • telemetry_span_context: A unique identifier for this span

  • [:thousand_island, :connection, :socket_shutdown]

    Thousand Island has shutdown the client connection

    This event contains the following measurements:

    • monotonic_time: The time of this event, in :native units
    • way: The direction in which the socket was shut down

    This event contains the following metadata:

    • telemetry_span_context: A unique identifier for this span

Link to this section Summary

Types

t()

Functions

monotonic_time()

See System.monotonic_time/0.

Link to this section Types

Link to this type

t()

View Source 
@type t() :: %ThousandIsland.Telemetry{
  span_name: atom(),
  start_metadata: map(),
  start_time: integer(),
  telemetry_span_context: reference()
}

Link to this section Functions

Link to this function

monotonic_time()

View Source

See System.monotonic_time/0.