Telemetry

<p>R6 class for logging events in a structured format (JSON).</p>

A production-grade AI toolkit for R featuring a layered
architecture (Specification, Utilities, Providers, Core), request
interception support, robust error handling with exponential retry
delays, support for multiple AI model providers ('OpenAI',
'Anthropic', etc.), local small language model inference,
distributed 'MCP' ecosystem, multi-agent orchestration, progressive
knowledge loading through skills, and a global skill store for
sharing AI capabilities.

Yonghe Xia

aisdk

Unified Interface for AI Model Providers

Telemetry function

<p><div class="r6-fields"></div></p><dl>
<dt><code>trace_id</code></dt>
<dd><p>Current trace ID for the session.</p></dd><p></p><p>
<dt><code>pricing_table</code></dt>
<dd><p>Pricing for common models (USD per 1M tokens).</p></dd></p><p>
</p></dl><p></p>

Public fields


<div class="section" id="public-methods">
<h3>Public methods</h3><p></p><p><ul>
<li><p><a href="/link/Telemetry%24new()?package=aisdk&version=1.1.0" data-mini-rdoc="aisdk::Telemetry$new()"><code>Telemetry$new()</code></a></p></li>
<li><p><a href="/link/Telemetry%24log_event()?package=aisdk&version=1.1.0" data-mini-rdoc="aisdk::Telemetry$log_event()"><code>Telemetry$log_event()</code></a></p></li>
<li><p><a href="/link/Telemetry%24as_hooks()?package=aisdk&version=1.1.0" data-mini-rdoc="aisdk::Telemetry$as_hooks()"><code>Telemetry$as_hooks()</code></a></p></li>
<li><p><a href="/link/Telemetry%24calculate_cost()?package=aisdk&version=1.1.0" data-mini-rdoc="aisdk::Telemetry$calculate_cost()"><code>Telemetry$calculate_cost()</code></a></p></li>
<li><p><a href="/link/Telemetry%24clone()?package=aisdk&version=1.1.0" data-mini-rdoc="aisdk::Telemetry$clone()"><code>Telemetry$clone()</code></a></p></li>
</ul></p><p></p></div><p><hr>
<a id="method-Telemetry-new"></a></p><div class="section" id="method-new-">
<h3>Method <code>new()</code></h3>
<p>Initialize Telemetry</p><div class="section" id="usage">
<h4>Usage</h4>
<p><div class="r"></div></p><pre><code>Telemetry$new(trace_id = NULL)</code></pre><p></p></div><p></p>
</div><p></p><p><div class="section" id="arguments">
<h4>Arguments</h4>
<p><div class="arguments"></div></p><dl>
<dt><code>trace_id</code></dt>
<dd><p>Optional trace ID. If NULL, generates a random one.</p></dd></dl></div></p><p>
</p><p></p>
<p></p><p></p><p><hr>
<a id="method-Telemetry-log_event"></a></p><div class="section" id="method-log-event-">
<h3>Method <code>log_event()</code></h3>
<p>Log an event</p><div class="section" id="usage">
<h4>Usage</h4>
<p><div class="r"></div></p><pre><code>Telemetry$log_event(type, ...)</code></pre><p></p></div><p></p>
</div><p></p><p><div class="section" id="arguments">
<h4>Arguments</h4>
<p><div class="arguments"></div></p><dl>
<dt><code>type</code></dt>
<dd><p>Event type (e.g., "generation_start", "tool_call").</p></dd></dl></div></p><p>
<dt><code>...</code></dt>
<dd><p>Additional fields to log.</p></dd></p><p>
</p><p></p>
<p></p><p></p><p><hr>
<a id="method-Telemetry-as_hooks"></a></p><div class="section" id="method-as-hooks-">
<h3>Method <code>as_hooks()</code></h3>
<p>Create hooks for telemetry</p><div class="section" id="usage">
<h4>Usage</h4>
<p><div class="r"></div></p><pre><code>Telemetry$as_hooks()</code></pre><p></p></div><p></p>
</div><p></p><p><div class="section" id="returns">
<h4>Returns</h4>
<p>A HookHandler object pre-configured with telemetry logs.</p>
</div></p><p></p><p><hr>
<a id="method-Telemetry-calculate_cost"></a></p><div class="section" id="method-calculate-cost-">
<h3>Method <code>calculate_cost()</code></h3>
<p>Calculate estimated cost for a generation result</p><div class="section" id="usage">
<h4>Usage</h4>
<p><div class="r"></div></p><pre><code>Telemetry$calculate_cost(result, model_id = NULL)</code></pre><p></p></div><p></p>
</div><p></p><p><div class="section" id="arguments">
<h4>Arguments</h4>
<p><div class="arguments"></div></p><dl>
<dt><code>result</code></dt>
<dd><p>The GenerateResult object.</p></dd></dl></div></p><p>
<dt><code>model_id</code></dt>
<dd><p>Optional model ID string. if NULL, tries to guess from context (not reliable yet, passing in log_event might be better).</p></dd></p><p>
</p><p></p>

<div class="section" id="returns">
<h4>Returns</h4>
<p>Estimated cost in USD, or NULL if unknown.</p>
</div><p></p><p></p><p><hr>
<a id="method-Telemetry-clone"></a></p><div class="section" id="method-clone-">
<h3>Method <code>clone()</code></h3>
<p>The objects of this class are cloneable with this method.</p><div class="section" id="usage">
<h4>Usage</h4>
<p><div class="r"></div></p><pre><code>Telemetry$clone(deep = FALSE)</code></pre><p></p></div><p></p>
</div><p></p><p><div class="section" id="arguments">
<h4>Arguments</h4>
<p><div class="arguments"></div></p><dl>
<dt><code>deep</code></dt>
<dd><p>Whether to make a deep clone.</p></dd></dl></div></p><p>
</p><p></p>
<p></p><p>
</p>

Methods

Telemetry Class — Telemetry

<p><div class="r6-fields"></p><dl>
<dt><code>trace_id</code></dt>
<dd><p>Current trace ID for the session.</p></dd>


<dt><code>pricing_table</code></dt>
<dd><p>Pricing for common models (USD per 1M tokens).</p></dd>


</dl><p></div></p>


<div class='section' id='public-methods'>
<h3>Public methods</h3>

<ul>
<li><p><a href='#method-Telemetry-new'><code>Telemetry$new()</code></a></p></li>
<li><p><a href='#method-Telemetry-log_event'><code>Telemetry$log_event()</code></a></p></li>
<li><p><a href='#method-Telemetry-as_hooks'><code>Telemetry$as_hooks()</code></a></p></li>
<li><p><a href='#method-Telemetry-calculate_cost'><code>Telemetry$calculate_cost()</code></a></p></li>
<li><p><a href='#method-Telemetry-clone'><code>Telemetry$clone()</code></a></p></li>
</ul>

</div><p><hr>
<a id="method-Telemetry-new"></a></p><div class='section' id='method-new-'>
<h3>Method <code>new()</code></h3>
<p>Initialize Telemetry</p><div class='section' id='usage'>
<h4>Usage</h4>
<p><div class="r"></p><pre><code>Telemetry$new(trace_id = NULL)</code></pre><p></div></p>
</div>

<div class='section' id='arguments'>
<h4>Arguments</h4>
<p><div class="arguments"></p><dl>
<dt><code>trace_id</code></dt>
<dd><p>Optional trace ID. If NULL, generates a random one.</p></dd>


</dl><p></div></p>
</div>

</div><p><hr>
<a id="method-Telemetry-log_event"></a></p><div class='section' id='method-log-event-'>
<h3>Method <code>log_event()</code></h3>
<p>Log an event</p><div class='section' id='usage'>
<h4>Usage</h4>
<p><div class="r"></p><pre><code>Telemetry$log_event(type, ...)</code></pre><p></div></p>
</div>

<div class='section' id='arguments'>
<h4>Arguments</h4>
<p><div class="arguments"></p><dl>
<dt><code>type</code></dt>
<dd><p>Event type (e.g., "generation_start", "tool_call").</p></dd>


<dt><code>...</code></dt>
<dd><p>Additional fields to log.</p></dd>


</dl><p></div></p>
</div>

</div><p><hr>
<a id="method-Telemetry-as_hooks"></a></p><div class='section' id='method-as-hooks-'>
<h3>Method <code>as_hooks()</code></h3>
<p>Create hooks for telemetry</p><div class='section' id='usage'>
<h4>Usage</h4>
<p><div class="r"></p><pre><code>Telemetry$as_hooks()</code></pre><p></div></p>
</div>

<div class='section' id='returns'>
<h4>Returns</h4>
<p>A HookHandler object pre-configured with telemetry logs.</p>
</div>

</div><p><hr>
<a id="method-Telemetry-calculate_cost"></a></p><div class='section' id='method-calculate-cost-'>
<h3>Method <code>calculate_cost()</code></h3>
<p>Calculate estimated cost for a generation result</p><div class='section' id='usage'>
<h4>Usage</h4>
<p><div class="r"></p><pre><code>Telemetry$calculate_cost(result, model_id = NULL)</code></pre><p></div></p>
</div>

<div class='section' id='arguments'>
<h4>Arguments</h4>
<p><div class="arguments"></p><dl>
<dt><code>result</code></dt>
<dd><p>The GenerateResult object.</p></dd>


<dt><code>model_id</code></dt>
<dd><p>Optional model ID string. if NULL, tries to guess from context (not reliable yet, passing in log_event might be better).</p></dd>


</dl><p></div></p>
</div>
<div class='section' id='returns'>
<h4>Returns</h4>
<p>Estimated cost in USD, or NULL if unknown.</p>
</div>

</div><p><hr>
<a id="method-Telemetry-clone"></a></p><div class='section' id='method-clone-'>
<h3>Method <code>clone()</code></h3>
<p>The objects of this class are cloneable with this method.</p><div class='section' id='usage'>
<h4>Usage</h4>
<p><div class="r"></p><pre><code>Telemetry$clone(deep = FALSE)</code></pre><p></div></p>
</div>

<div class='section' id='arguments'>
<h4>Arguments</h4>
<p><div class="arguments"></p><dl>
<dt><code>deep</code></dt>
<dd><p>Whether to make a deep clone.</p></dd>


</dl><p></div></p>
</div>

</div>


Telemetry: Telemetry Class

Description

Arguments

Public fields

Methods

Public methods

Method `new()`

Usage

Arguments

Method `log_event()`

Usage

Arguments

Method `as_hooks()`

Usage

Returns

Method `calculate_cost()`

Usage

Arguments

Returns

Method `clone()`

Usage

Arguments

Description

Arguments

Public fields

Methods

Public methods

Method new()

Usage

Arguments

Method log_event()

Usage

Arguments

Method as_hooks()

Usage

Returns

Method calculate_cost()

Usage

Arguments

Returns

Method clone()

Usage

Arguments

Method `new()`

Method `log_event()`

Method `as_hooks()`

Method `calculate_cost()`

Method `clone()`