@opencensus/exporter-ocagent

OpenCensus Agent Exporter allows user to send collected trace to the OpenCensus Agent

Usage no npm install needed!

<script type="module">
  import opencensusExporterOcagent from 'https://cdn.skypack.dev/@opencensus/exporter-ocagent';
</script>

README

OpenCensus Agent Exporter for Node.js

Gitter chat

OpenCensus Agent Exporter allows the user to send collected traces with OpenCensus Node.js to the OpenCensus Agent or Collector.

The library is in alpha stage and the API is subject to change.

Installation

Install OpenCensus Agent Exporter with:

npm install @opencensus/nodejs
npm install @opencensus/exporter-ocagent

Usage

Instance the exporter on your application. For javascript:

const tracing = require('@opencensus/nodejs');
const ocagent = require('@opencensus/exporter-ocagent');

const exporter = new ocagent.OCAgentExporter({
  // ... configuration options ...
});

tracing.registerExporter(exporter).start();

Similarly for Typescript:

import * as tracing from '@opencensus/nodejs';
import { OCAgentExporter } from '@opencensus/exporter-ocagent';

const exporter = new OCAgentExporter({
  // ... configuration options ...
});

Now, register the exporter and start tracing.

tracing.start({exporter: exporter});

or

tracing.registerExporter(exporter).start();

Configuration Options

The following options are available through the construtor options.

Option | Type | Description ----------------|-------------------------|- serviceName | string | Name of the service. Defaults to Anonymous Service. host | string | Host or ip of the agent. Defaults to localhost. port | number | Port of the agent. Defaults to 55678. credentials | grpc.ChannelCredentials | Credentials to use for grpc connection to agent. Defaults to grpc.credentials.createInsecure(). attributes | {[key: string]: string} | Map of key-value pairs to associate with the Node. bufferSize | number | Maximum size of the span buffer. bufferTimeout | number | Max time (in milliseconds) for the buffer can wait before exporting spans. logger | Logger | Logger to use for output.

Useful links