sourcemaps

Creates, updates, deletes, gets or lists a sourcemaps resource.

Overview

Name	sourcemaps
Type	Resource
Id	datadog.digital_experience.sourcemaps

Fields

The following fields are returned by SELECT queries:

get_sourcemaps

Name	Datatype	Description
id	string	The unique identifier of the source map file, typically the path to the file. (example: path/to/sourcemap.js.map)
attributes	object	Attributes of a JavaScript source map file.
type	string	The resource type for source map file objects. (sourcemap_files) (example: sourcemap_files)

list_sourcemaps

Name	Datatype	Description
id	string	The unique identifier of the source map. (example: 5)
attributes	object	Attributes of a JavaScript source map.
type	string	The resource type for source map objects. (sourcemaps) (example: sourcemaps)

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
get_sourcemaps	select	filename, service, version		Retrieves the content of a specific JavaScript source map file by its<br />filename, service name, and version.
list_sourcemaps	select		mapkind, page[size], page[number], filter[service], filter[version], filter[variant], filter[id], filter[build_id], filter[uuid], filter[platform], filter[build_number], filter[bundle_name], filter[arch], filter[symbol_source], filter[origin], filter[origin_version], filter[filename], filter[debug_id], filter[gnu_build_id], filter[go_build_id], filter[file_hash]	Retrieves a paginated list of source maps matching the specified filter criteria.
delete_sourcemaps	delete	mapkind, dry_run	filter[service], filter[version], filter[variant], filter[id], filter[build_id], filter[uuid], filter[platform], filter[build_number], filter[bundle_name], filter[arch], filter[symbol_source], filter[origin], filter[origin_version], filter[filename], filter[debug_id], filter[gnu_build_id], filter[go_build_id], filter[file_hash]	Deletes source maps matching the specified filter criteria. Supports<br />dry-run mode to preview which source maps would be deleted without<br />performing the actual deletion.
restore_sourcemaps	exec	mapkind, dry_run	filter[service], filter[version], filter[variant], filter[id], filter[build_id], filter[uuid], filter[platform], filter[build_number], filter[bundle_name], filter[arch], filter[symbol_source], filter[origin], filter[origin_version], filter[filename], filter[debug_id], filter[gnu_build_id], filter[go_build_id], filter[file_hash]	Restores previously deleted source maps matching the specified filter<br />criteria. Supports dry-run mode to preview which source maps would be<br />restored without performing the actual restoration.

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

Name	Datatype	Description
dry_run	boolean	When set to true, returns the source maps that would be restored without performing the actual restoration. When set to false, performs the restoration.
filename	string	The path to the source map file.
mapkind	string	The type of source map. Valid values are js, jvm, ios, react, flutter, elf, ndk, il2cpp.
service	string	The service name associated with the source map.
site	string	The Datadog site (region) for your organization, for example datadoghq.com, us3.datadoghq.com, us5.datadoghq.com, ap1.datadoghq.com, ap2.datadoghq.com, datadoghq.eu, ddog-gov.com. Resolved from the DD_SITE environment variable when set. Optional: defaults to datadoghq.com, or the value of the DD_SITE environment variable when set; a WHERE value overrides both.
version	string	The version of the service associated with the source map.
filter[arch]	array	Filter by architecture values (multiple values allowed). Supported for flutter, elf, and ndk.
filter[build_id]	array	Filter by build ID values (multiple values allowed). Supported for jvm, ndk, and il2cpp.
filter[build_number]	array	Filter by build number values (multiple values allowed). Supported for react.
filter[bundle_name]	array	Filter by bundle name values (multiple values allowed). Supported for react.
filter[debug_id]	string	Filter by debug ID (single value). Supported for react.
filter[file_hash]	string	Filter by file hash (single value). Supported for elf.
filter[filename]	string	Filter by filename (single value). Supported for js, elf, and ndk.
filter[gnu_build_id]	string	Filter by GNU build ID (single value). Supported for elf.
filter[go_build_id]	string	Filter by Go build ID (single value). Supported for elf.
filter[id]	array	Filter by source map ID values (multiple values allowed). Supported for all map kinds.
filter[origin]	array	Filter by origin values (multiple values allowed). Supported for elf.
filter[origin_version]	array	Filter by origin version values (multiple values allowed). Supported for elf.
filter[platform]	array	Filter by platform values (multiple values allowed). Supported for react.
filter[service]	array	Filter by service names (multiple values allowed). Required for js, jvm, react, and flutter map kinds.
filter[symbol_source]	array	Filter by symbol source values (multiple values allowed). Supported for elf.
filter[uuid]	array	Filter by UUID values (multiple values allowed). Supported for ios.
filter[variant]	array	Filter by variant values (multiple values allowed). Supported for jvm.
filter[version]	array	Filter by version values (multiple values allowed, maximum 10). Required for js, jvm, react, and flutter map kinds.
mapkind	string	The type of source map. Defaults to js.
page[number]	integer (int64)	The page number to retrieve, starting from 1.
page[size]	integer (int64)	The number of results to return per page. Must be at least 1.

SELECT examples

get_sourcemaps

Retrieves the content of a specific JavaScript source map file by its<br />filename, service name, and version.

SELECT
id,
attributes,
type
FROM datadog.digital_experience.sourcemaps
WHERE filename = '{{ filename }}' -- required
AND service = '{{ service }}' -- required
AND version = '{{ version }}' -- required
;

list_sourcemaps

Retrieves a paginated list of source maps matching the specified filter criteria.

SELECT
id,
attributes,
type
FROM datadog.digital_experience.sourcemaps
WHERE mapkind = '{{ mapkind }}'
AND page[size] = '{{ page[size] }}'
AND page[number] = '{{ page[number] }}'
AND filter[service] = '{{ filter[service] }}'
AND filter[version] = '{{ filter[version] }}'
AND filter[variant] = '{{ filter[variant] }}'
AND filter[id] = '{{ filter[id] }}'
AND filter[build_id] = '{{ filter[build_id] }}'
AND filter[uuid] = '{{ filter[uuid] }}'
AND filter[platform] = '{{ filter[platform] }}'
AND filter[build_number] = '{{ filter[build_number] }}'
AND filter[bundle_name] = '{{ filter[bundle_name] }}'
AND filter[arch] = '{{ filter[arch] }}'
AND filter[symbol_source] = '{{ filter[symbol_source] }}'
AND filter[origin] = '{{ filter[origin] }}'
AND filter[origin_version] = '{{ filter[origin_version] }}'
AND filter[filename] = '{{ filter[filename] }}'
AND filter[debug_id] = '{{ filter[debug_id] }}'
AND filter[gnu_build_id] = '{{ filter[gnu_build_id] }}'
AND filter[go_build_id] = '{{ filter[go_build_id] }}'
AND filter[file_hash] = '{{ filter[file_hash] }}'
;

DELETE examples

delete_sourcemaps

Deletes source maps matching the specified filter criteria. Supports<br />dry-run mode to preview which source maps would be deleted without<br />performing the actual deletion.

DELETE FROM datadog.digital_experience.sourcemaps
WHERE mapkind = '{{ mapkind }}' --required
AND dry_run = '{{ dry_run }}' --required
AND filter[service] = '{{ filter[service] }}'
AND filter[version] = '{{ filter[version] }}'
AND filter[variant] = '{{ filter[variant] }}'
AND filter[id] = '{{ filter[id] }}'
AND filter[build_id] = '{{ filter[build_id] }}'
AND filter[uuid] = '{{ filter[uuid] }}'
AND filter[platform] = '{{ filter[platform] }}'
AND filter[build_number] = '{{ filter[build_number] }}'
AND filter[bundle_name] = '{{ filter[bundle_name] }}'
AND filter[arch] = '{{ filter[arch] }}'
AND filter[symbol_source] = '{{ filter[symbol_source] }}'
AND filter[origin] = '{{ filter[origin] }}'
AND filter[origin_version] = '{{ filter[origin_version] }}'
AND filter[filename] = '{{ filter[filename] }}'
AND filter[debug_id] = '{{ filter[debug_id] }}'
AND filter[gnu_build_id] = '{{ filter[gnu_build_id] }}'
AND filter[go_build_id] = '{{ filter[go_build_id] }}'
AND filter[file_hash] = '{{ filter[file_hash] }}'
;

Lifecycle Methods

EXEC variables use wire (API) names.

restore_sourcemaps

Restores previously deleted source maps matching the specified filter<br />criteria. Supports dry-run mode to preview which source maps would be<br />restored without performing the actual restoration.

EXEC datadog.digital_experience.sourcemaps.restore_sourcemaps 
@mapkind='{{ mapkind }}' --required, 
@dry_run='{{ dry_run }}' --required, 
@filter[service]='{{ filter[service] }}', 
@filter[version]='{{ filter[version] }}', 
@filter[variant]='{{ filter[variant] }}', 
@filter[id]='{{ filter[id] }}', 
@filter[build_id]='{{ filter[build_id] }}', 
@filter[uuid]='{{ filter[uuid] }}', 
@filter[platform]='{{ filter[platform] }}', 
@filter[build_number]='{{ filter[build_number] }}', 
@filter[bundle_name]='{{ filter[bundle_name] }}', 
@filter[arch]='{{ filter[arch] }}', 
@filter[symbol_source]='{{ filter[symbol_source] }}', 
@filter[origin]='{{ filter[origin] }}', 
@filter[origin_version]='{{ filter[origin_version] }}', 
@filter[filename]='{{ filter[filename] }}', 
@filter[debug_id]='{{ filter[debug_id] }}', 
@filter[gnu_build_id]='{{ filter[gnu_build_id] }}', 
@filter[go_build_id]='{{ filter[go_build_id] }}', 
@filter[file_hash]='{{ filter[file_hash] }}'
;