import { Span } from 'dd-trace';
import * as Formats from 'dd-trace/ext/formats';
type Nullable<T> = T | null;
type PrivateDatadogContext = {
    req: Record<any, any> & {
        _datadog?: {
            span?: Span;
        };
    };
};
/**
 * The root span is an undocumented internal property that DataDog adds to `context.req`.
 * The root span is required in order to add searchable tags.
 * Unfortunately, there is no API to access the root span directly.
 * See: node_modules/dd-trace/src/plugins/util/web.js
 *
 * @param context A Koa context object
 */
declare const getRootSpanFromRequestContext: (context: PrivateDatadogContext) => Nullable<Span>;
/**
 * Add tags to a span to have more context about how and why it was running.
 * If added to the root span, tags are searchable and filterable.
 *
 * @param tags An object with the tags to add to the span
 * @param span An optional span object to add the tags to. If none provided, the current span will be used.
 */
declare const addTags: (tags: Record<string, string | undefined>, span?: Nullable<Span>) => void;
/**
 * If your logger cannot be automatically injected, you must manually inject the log message.
 * This function will mutate the metadata parameter to include IDs tieing it back to the APM span.
 * https://docs.datadoghq.com/tracing/advanced/connect_logs_and_traces/?tab=nodejs
 *
 * @param metadata The log metadata to augment
 * @param span An optional span object to add the tags to. If none provided, the current span will be used.
 */
declare const addLogMetadata: (metadata: Record<string, any>, span?: Span) => void;
/**
 * Datadog will mark spans as errors if they throw an error.
 * This function will allow other spans to show up as errors as well.
 *
 * @param error An Error object.
 * @param span An optional span object to add the tags to. If none provided, the current span will be used.
 */
declare const markAsError: (error: Error, span?: Span) => void;
export { Span, Formats, getRootSpanFromRequestContext, addTags, addLogMetadata, markAsError, };
//# sourceMappingURL=util.d.ts.map