@azure/monitor-opentelemetry-exporter 1.0.0-beta.7 → 1.0.0-beta.8

package/types/monitor-opentelemetry-exporter.d.ts

@@ -1,7 +1,10 @@
+import { AggregationTemporality } from '@opentelemetry/sdk-metrics-base';
 import { ExportResult } from '@opentelemetry/core';
+import { PushMetricExporter } from '@opentelemetry/sdk-metrics-base';
 import { ReadableSpan } from '@opentelemetry/sdk-trace-base';
+import { ResourceMetrics } from '@opentelemetry/sdk-metrics-base';
 import { SpanExporter } from '@opentelemetry/sdk-trace-base';
-import { TokenCredential } from '@azure/core-http';
+import { TokenCredential } from '@azure/core-auth';
 
 /**
  * Provides configuration options for AzureMonitorTraceExporter.
@@ -25,19 +28,78 @@ export declare interface AzureExporterConfig {
 /**
  * Azure Monitor OpenTelemetry Trace Exporter.
  */
-export declare class AzureMonitorTraceExporter implements SpanExporter {
+export declare abstract class AzureMonitorBaseExporter {
+    /**
+     * Instrumentation key to be used for exported envelopes
+     */
+    protected readonly _instrumentationKey: string;
     private readonly _persister;
     private readonly _sender;
     private _numConsecutiveRedirects;
     private _retryTimer;
+    /**
+     * Exporter internal configuration
+     */
     private readonly _options;
     /**
-     * Initializes a new instance of the AzureMonitorTraceExporter class.
+     * Initializes a new instance of the AzureMonitorBaseExporter class.
      * @param AzureExporterConfig - Exporter configuration.
      */
     constructor(options?: AzureExporterConfig);
+    /**
+     * Persist envelopes to disk
+     */
     private _persist;
-    private exportEnvelopes;
+    /**
+     * Shutdown exporter
+     */
+    protected _shutdown(): Promise<void>;
+    /**
+     * Export envelopes
+     */
+    protected _exportEnvelopes(envelopes: TelemetryItem[]): Promise<ExportResult>;
+    private _sendFirstPersistedFile;
+    private _isNetworkError;
+}
+
+/**
+ * Azure Monitor OpenTelemetry Metric Exporter.
+ */
+export declare class AzureMonitorMetricExporter extends AzureMonitorBaseExporter implements PushMetricExporter {
+    /**
+     * Initializes a new instance of the AzureMonitorMetricExporter class.
+     * @param AzureExporterConfig - Exporter configuration.
+     */
+    constructor(options?: AzureExporterConfig);
+    /**
+     * Export OpenTelemetry resource metrics.
+     * @param metrics - Resource metrics to export.
+     * @param resultCallback - Result callback.
+     */
+    export(metrics: ResourceMetrics, resultCallback: (result: ExportResult) => void): Promise<void>;
+    /**
+     * Shutdown AzureMonitorMetricExporter.
+     */
+    shutdown(): Promise<void>;
+    /**
+     * Select aggregation temporality
+     */
+    selectAggregationTemporality(): AggregationTemporality;
+    /**
+     * Force flush
+     */
+    forceFlush(): Promise<void>;
+}
+
+/**
+ * Azure Monitor OpenTelemetry Trace Exporter.
+ */
+export declare class AzureMonitorTraceExporter extends AzureMonitorBaseExporter implements SpanExporter {
+    /**
+     * Initializes a new instance of the AzureMonitorTraceExporter class.
+     * @param AzureExporterConfig - Exporter configuration.
+     */
+    constructor(options?: AzureExporterConfig);
     /**
      * Export OpenTelemetry spans.
      * @param spans - Spans to export.
@@ -48,8 +110,22 @@ export declare class AzureMonitorTraceExporter implements SpanExporter {
      * Shutdown AzureMonitorTraceExporter.
      */
     shutdown(): Promise<void>;
-    private _sendFirstPersistedFile;
-    private _isNetworkError;
+}
+
+/** Data struct to contain only C section with custom fields. */
+export declare interface MonitorBase {
+    /** Name of item (B section) if any. If telemetry data is derived straight from this, this should be null. */
+    baseType?: string;
+    /** The data payload for the telemetry request */
+    baseData?: MonitorDomain;
+}
+
+/** The abstract common base of all domains. */
+export declare interface MonitorDomain {
+    /** Describes unknown properties. The value of an unknown property can be of "any" type. */
+    [property: string]: any;
+    /** Schema version */
+    version: number;
 }
 
 /**
@@ -62,4 +138,26 @@ export declare enum ServiceApiVersion {
     V2 = "2020-09-15_Preview"
 }
 
+/** System variables for a telemetry item. */
+export declare interface TelemetryItem {
+    /** Envelope version. For internal use only. By assigning this the default, it will not be serialized within the payload unless changed to a value other than #1. */
+    version?: number;
+    /** Type name of telemetry data item. */
+    name: string;
+    /** Event date time when telemetry item was created. This is the wall clock time on the client when the event was generated. There is no guarantee that the client's time is accurate. This field must be formatted in UTC ISO 8601 format, with a trailing 'Z' character, as described publicly on https://en.wikipedia.org/wiki/ISO_8601#UTC. Note: the number of decimal seconds digits provided are variable (and unspecified). Consumers should handle this, i.e. managed code consumers should not use format 'O' for parsing as it specifies a fixed length. Example: 2009-06-15T13:45:30.0000000Z. */
+    time: Date;
+    /** Sampling rate used in application. This telemetry item represents 100 / sampleRate actual telemetry items. */
+    sampleRate?: number;
+    /** Sequence field used to track absolute order of uploaded events. */
+    sequence?: string;
+    /** The instrumentation key of the Application Insights resource. */
+    instrumentationKey?: string;
+    /** Key/value collection of context properties. See ContextTagKeys for information on available properties. */
+    tags?: {
+        [propertyName: string]: string;
+    };
+    /** Telemetry data item. */
+    data?: MonitorBase;
+}
+
 export { }

package/CHANGELOG.md

@@ -1,51 +0,0 @@
-# Release History
-
-## 1.0.0-beta.7 (2022-04-05)
-
-### Features Added
-
-- Added authentication support using @azure/identity TokenCredential.
-- Added file access control in Windows for retriable telemetry.
-
-## 1.0.0-beta.6 (2022-02-08)
-
-### Other Changes
-
-- Updated OpenTelemtry dependencies to their latest available versions.
-
-## 1.0.0-beta.5 (2021-10-05)
-
-### Bugs Fixed
-
-- Fixed issue with SDK version field not being populated correctly.
-
-### Other Changes
-
-- Updated mapping for Azure Monitor according to latest specs.
-
-## 1.0.0-beta.4 (2021-07-07)
-
-- Updating OpenTelemetry API to 1.0.0
-- Adding support for temporary and permanent redirect
-- Adding cleanup process for older temp files
-
-## 1.0.0-beta.3 (2021-02-10)
-
-- Rename package to `@azure/monitor-opentelemetry-exporter`
-- Added serviceApiVersion config
-- Open Telemetry dependency updates
-
-## 1.0.0-beta.2 (2021-01-20)
-
-- Ship the correct type declaration file
-
-## 1.0.0-beta.1 (2021-01-13)
-
-- OT Exporter retry when there are network issues
-- OpenTelemetry Exporter using Resources API to get service properties
-- Rename package to `@azure/opentelemetry-exporter-azure-monitor`
-- [BREAKING] Deprecate all configuration options except for `connectionString`
-- [BREAKING] Removed support for `TelemetryProcessor`
-- (internal) Migrate to autorest generated HttpClient and Envelope Interfaces
-- Migrate to Azure SDK for JS repository
-- Adds support for Event Hubs Distributed Tracing [#10575](https://github.com/Azure/azure-sdk-for-js/pull/10575)