Le widget Treemap vous permet d’afficher les proportions d’un ou plusieurs jeux de données. Ce widget peut afficher un seul jeu de données avec les proportions correspondantes, ou plusieurs jeux de données avec des proportions imbriquées.
Configuration
Sélectionnez parmi les sources de données disponibles.
Configurez la requête. Voir les ressources suivantes pour en savoir plus :
Métriques : consultez la documentation sur les requêtes pour configurer une requête de métrique.
Événements : consultez la documentation sur la recherche de logs pour configurer une requête d’événement de log.
(Facultatif) Modifiez la requête avec une formule.
Personnalisez votre graphique.
Personnalisation
Liens de contexte
Les liens de contexte sont activés par défaut, mais vous pouvez les désactiver si vous le souhaitez. Ils relient les widgets du dashboard à d’autres pages (dans Datadog ou sur des sites externes).
Affichage et interactions
Filtrer et mettre en évidence
Si plusieurs groupes de données sont représentés simultanément, vous pouvez filtrer le widget pour afficher une catégorie spécifique et visualiser les proportions au sein de celle-ci.
Pour filtrer et mettre en évidence une catégorie spécifique, cliquez sur le rectangle extérieur correspondant à cette catégorie. Pour revenir à la vue précédente, cliquez sur le bouton Back en haut à gauche du titre du widget.
Accéder au menu contextuel
Pour accéder au menu contextuel, passez d’abord la souris sur une catégorie individuelle : il peut s’agir d’une catégorie imbriquée ou d’un groupe, tel que Canada ou Canada > Edge dans l’exemple suivant. Un bouton déroulant apparaît alors dans le coin supérieur droit. Lorsqu’il est cliqué, le menu contextuel s’affiche.
Plein écran
L’affichage du widget Treemap en plein écran révèle l’ensemble standard des options plein écran.
Widget Graphique circulaire
Comme le widget Treemap, le widget Pie Chart peut également être utilisé pour afficher des proportions imbriquées. La principale différence entre les deux est que le widget Pie Chart affiche les proportions en secteurs radiaux, tandis que le widget Treemap affiche des rectangles imbriqués.
DEPRECATED: (deprecated) The attribute formerly used to determine color in the widget.
Allowed enum values: user
default: user
custom_links
[object]
List of custom links.
is_hidden
boolean
The flag for toggling context menu link visibility.
label
string
The label for the custom link URL. Keep the label short and descriptive. Use metrics and tags as variables.
link
string
The URL of the custom link. URL must include http or https. A relative URL must start with /.
override_label
string
The label ID that refers to a context menu link. Can be logs, hosts, traces, profiles, processes, containers, or rum.
description
string
The description of the widget.
group_by
enum
DEPRECATED: (deprecated) The attribute formerly used to group elements in the widget.
Allowed enum values: user,family,process
requests [required]
[object]
List of treemap widget requests.
formulas
[object]
List of formulas that operate on queries.
alias
string
Expression alias.
cell_display_mode
enum
Define a display mode for the table cell.
Allowed enum values: number,bar,trend
cell_display_mode_options
object
Cell display mode options for the widget formula. (only if cell_display_mode is set to trend).
trend_type
enum
Trend type for the cell display mode options.
Allowed enum values: area,line,bars
y_scale
enum
Y scale for the cell display mode options.
Allowed enum values: shared,independent
conditional_formats
[object]
List of conditional formats.
comparator [required]
enum
Comparator to apply.
Allowed enum values: =,>,>=,<,<=
custom_bg_color
string
Color palette to apply to the background, same values available as palette.
custom_fg_color
string
Color palette to apply to the foreground, same values available as palette.
hide_value
boolean
True hides values.
image_url
string
Displays an image as the background.
metric
string
Metric from the request to correlate this conditional format with.
palette [required]
enum
Color palette to apply.
Allowed enum values: blue,custom_bg,custom_image,custom_text,gray_on_white,grey,green,orange,red,red_on_whiteShow 9 more,white_on_gray,white_on_green,green_on_white,white_on_red,white_on_yellow,yellow_on_white,black_on_light_yellow,black_on_light_green,black_on_light_red
timeframe
string
Defines the displayed timeframe.
value [required]
double
Value for the comparator.
formula [required]
string
String expression built from queries, formulas, and functions.
limit
object
Options for limiting results returned.
count
int64
Number of results to return.
order
enum
Direction of sort.
Allowed enum values: asc,desc
default: desc
number_format
object
Number format options for the widget.
unit
<oneOf>
Number format unit.
Option 1
object
Canonical unit.
per_unit_name
string
The name of the unit per item.
type
enum
The type of unit scale.
Allowed enum values: canonical_unit
unit_name
string
The name of the unit.
Option 2
object
Custom unit.
label
string
The label for the custom unit.
type
enum
The type of custom unit.
Allowed enum values: custom_unit_label
unit_scale
object
The definition of NumberFormatUnitScale object.
type
enum
The type of unit scale.
Allowed enum values: canonical_unit
The source organization UUID for cross organization queries. Feature in Private Beta.
data_source [required]
enum
Data source for event platform-based queries.
Allowed enum values: logs,spans,network,rum,security_signals,profiles,audit,events,ci_tests,ci_pipelinesShow 4 more,incident_analytics,product_analytics,on_call_events,errors
group_by
<oneOf>
Group by configuration for a formula and functions events query. Accepts either a list of facet objects or a flat object that specifies a list of facet fields.
Fixed-width time bucket interval in milliseconds for time series queries. Mutually exclusive with rollup.
metric
string
Measurable attribute to compute.
name
string
Name of the compute for use in formulas.
rollup
object
Calendar-aligned time bucket for time series queries (for example, day, week, or month boundaries). Mutually exclusive with interval.
alignment
string
Alignment of the interval. Valid values depend on the interval type. For day, use hours (for example, 1am, 2pm, or 14). For week, use day names (for example, monday). For month, use day-of-month ordinals (for example, 1st, 15th). For year or quarter, use month names (for example, january).
quantity
int64
Quantity of the interval.
timezone
string
Timezone for the interval.
type [required]
enum
Type of calendar interval.
Allowed enum values: day,week,month,year,quarter,minute,hour
data_source [required]
enum
Data source for Product Analytics Extended queries.
Allowed enum values: product_analytics_extended
group_by
[object]
Group by configuration.
facet [required]
string
Facet name to group by.
limit
int32
Maximum number of groups to return.
should_exclude_missing
boolean
Whether to exclude events missing the group-by facet.
Time bucket interval in milliseconds for time series queries.
metric
enum
Metric for User Journey formula compute. __dd.conversion and __dd.conversion_rate accept count and cardinality as aggregations. __dd.time_to_convert accepts avg, median, pc75, pc95, pc98, pc99, min, and max.
Allowed enum values: __dd.conversion,__dd.conversion_rate,__dd.time_to_convert
target
object
Target for user journey search.
end
string
End value.
start
string
Start value.
type [required]
string
Target type.
value
string
Target value.
data_source [required]
enum
Data source for user journey funnel queries.
Allowed enum values: product_analytics_journey
group_by
[object]
Group by configuration.
facet [required]
string
Facet name to group by.
limit
int32
Maximum number of groups to return.
should_exclude_missing
boolean
Whether to exclude events missing the group-by facet.
Target for retention group by.
Allowed enum values: cohort,return_period
name [required]
string
Name of the query for use in formulas.
search [required]
object
Search configuration for retention queries.
cohort_criteria [required]
object
Cohort criteria for retention queries.
base_query [required]
object
Base query for Product Analytics.
data_source [required]
enum
Data source for Product Analytics event queries.
Allowed enum values: product_analytics
search [required]
object
Search configuration for Product Analytics event query.
query [required]
string
RUM event search query used to filter views or actions.
time_interval [required]
object
Time interval for cohort criteria.
type [required]
enum
Type of time interval for cohort criteria.
Allowed enum values: calendar
value [required]
object
Calendar interval definition.
alignment
string
Alignment of the interval. Valid values depend on the interval type. For day, use hours (for example, 1am, 2pm, or 14). For week, use day names (for example, monday). For month, use day-of-month ordinals (for example, 1st, 15th). For year or quarter, use month names (for example, january).
quantity
int64
Quantity of the interval.
timezone
string
Timezone for the interval.
type [required]
enum
Type of calendar interval.
Allowed enum values: day,week,month,year,quarter,minute,hour
filters
object
Filters for retention queries.
audience_filters
object
Product Analytics/RUM audience filters.
accounts
[object]
name
string
The name of the account subquery.
query
string
The query string for the account subquery.
filter_condition
string
An optional filter condition applied to the audience subquery.
segments
[object]
name
string
The name of the segment subquery.
segment_id
string
The unique identifier of the segment.
users
[object]
name
string
The name of the user subquery.
query
string
The query string for the user subquery.
string_filter
string
String filter.
retention_entity [required]
enum
Entity to track for retention.
Allowed enum values: @usr.id,@account.id
return_condition [required]
enum
Condition for counting user return.
Allowed enum values: conversion_on,conversion_on_or_after
return_criteria
object
Return criteria for retention queries.
base_query [required]
object
Base query for Product Analytics.
data_source [required]
enum
Data source for Product Analytics event queries.
Allowed enum values: product_analytics
search [required]
object
Search configuration for Product Analytics event query.
query [required]
string
RUM event search query used to filter views or actions.
time_interval
object
Time interval for return criteria.
type [required]
enum
Type of time interval for return criteria.
Allowed enum values: fixed
unit [required]
enum
Unit of time for retention return criteria interval.
Allowed enum values: day,week,month
value [required]
double
Value of the time interval.
response_format
enum
Timeseries, scalar, or event list response. Event list response formats are supported by Geomap widgets.
Allowed enum values: timeseries,scalar,event_list
sort
object
The controls for sorting the widget.
count
int64
The number of items to limit the widget to.
order_by
[ <oneOf>]
The array of items to sort the widget by in order.
Set the sort type to group.
Allowed enum values: group
style
object
Define request widget style.
line_type
enum
Type of lines displayed.
Allowed enum values: dashed,dotted,solid
line_width
enum
Width of line displayed.
Allowed enum values: normal,thick,thin
order_by
enum
How to order series in timeseries visualizations.
tags: Order series alphabetically by tag name (default behavior)
values: Order series by their current metric values (typically descending)
Allowed enum values: tags,values
palette
string
Color palette to apply to the widget.
size_by
enum
DEPRECATED: (deprecated) The attribute formerly used to determine size in the widget.
Allowed enum values: pct_cpu,pct_mem
time
<oneOf>
Time setting for the widget.
Option 1
object
Wrapper for live span
hide_incomplete_cost_data
boolean
Whether to hide incomplete cost data in the widget.
live_span
enum
The available timeframes depend on the widget you are using.
Allowed enum values: 1m,5m,10m,15m,30m,1h,4h,1d,2d,1wShow 7 more,1mo,3mo,6mo,week_to_date,month_to_date,1y,alert
Option 2
object
Used for arbitrary live span times, such as 17 minutes or 6 hours.
hide_incomplete_cost_data
boolean
Whether to hide incomplete cost data in the widget.
type [required]
enum
Type "live" denotes a live span in the new format.
Allowed enum values: live
unit [required]
enum
Unit of the time span.
Allowed enum values: minute,hour,day,week,month,year
value [required]
int64
Value of the time span.
Option 3
object
Used for fixed span times, such as 'March 1 to March 7'.
from [required]
int64
Start time in milliseconds since epoch.
hide_incomplete_cost_data
boolean
Whether to hide incomplete cost data in the widget.
to [required]
int64
End time in milliseconds since epoch.
type [required]
enum
Type "fixed" denotes a fixed span.
Allowed enum values: fixed
title
string
Title of your widget.
type [required]
enum
Type of the treemap widget.
Allowed enum values: treemap
default: treemap
{"color_by":"user","custom_links":[{"is_hidden":false,"label":"Search logs for {{host}}","link":"https://app.datadoghq.com/logs?query={{host}}","override_label":"logs"}],"description":"string","group_by":"user","requests":[{"formulas":[{"alias":"string","cell_display_mode":"number","cell_display_mode_options":{"trend_type":"area","y_scale":"shared"},"conditional_formats":[{"comparator":">","custom_bg_color":"string","custom_fg_color":"string","hide_value":false,"image_url":"string","metric":"string","palette":"blue","timeframe":"string","value":0}],"formula":"func(a) + b","limit":{"count":"integer","order":"string"},"number_format":{"unit":{"per_unit_name":"bytes","type":"canonical_unit","unit_name":"bytes"},"unit_scale":{"type":"canonical_unit","unit_name":"bytes"}},"style":{"palette":"classic","palette_index":1}}],"q":"string","queries":[],"response_format":"timeseries","sort":{"count":"integer","order_by":[{"index":0,"order":"desc","type":"formula"}]},"style":{"line_type":"string","line_width":"string","order_by":"string","palette":"string"}}],"size_by":"pct_cpu","time":{"hide_incomplete_cost_data":false,"live_span":"5m"},"title":"string","type":"treemap"}
Pour aller plus loin
Documentation, liens et articles supplémentaires utiles: