ツリーマップウィジェットは、1 つのデータセットまたはデータセットの比率を表示することができます。このウィジェットは、単一のデータセットとそれに対応する比率、または複数のデータセットを入れ子にして比率を表示することができます。
コンフィギュレーション
- 利用可能なデータソースから選択します。
- クエリを構成します。詳しくは、次の資料をご覧ください。
- メトリクス: メトリクスのクエリを構成するには、クエリ作成のドキュメントを参照してください。
- イベント: ログイベントクエリの構成については、ログ検索に関するドキュメントを参照してください。
- (オプション) 式でクエリを修正します。
- グラフをカスタマイズします。
内容
コンテキストリンク
コンテキストリンクは、デフォルトで有効になっており、オンまたはオフに切り替えることができます。コンテキストリンクは、ダッシュボードウィジェットと他のページ (Datadog 内、またはサードパーティ製) の橋渡しをします。
表示とインタラクション
フィルターとフォーカス
複数のデータ群を一度にプロットする場合、ウィジェットを 1 つのカテゴリーにフィルターし、その中での比率を表示することが可能です。
フィルタリングして 1 つのカテゴリーにフォーカスするには、カテゴリーの外側の部分にカーソルを合わせてクリックします。前のビューに戻るには、ウィジェットの左上のヘッダーにある back ボタンをクリックします。
コンテキストメニューにアクセスする
コンテキストメニューにアクセスするには、まず個々のカテゴリーにカーソルを合わせます。カテゴリーは、ネストしたカテゴリーやグループ (次の例では Canada や Canada > Chrome など) であることがあります。これにより、右上隅に垂直方向の省略記号ボタンが表示されます。クリックすると、コンテキストメニューが表示されます。
全画面
ツリーマップウィジェットを全画面表示すると、標準の全画面表示オプションのセットが表示されます。
API
このウィジェットは、Dashboards API で使用することができます。
ツリーマップウィジェットのウィジェット JSON スキーマ定義は次のとおりです。
Expand All
DEPRECATED: (deprecated) The attribute formerly used to determine color in the widget.
Allowed enum values: user
default: user
The flag for toggling context menu link visibility.
The label for the custom link URL. Keep the label short and descriptive. Use metrics and tags as variables.
The URL of the custom link. URL must include http
or https
. A relative URL must start with /
.
The label ID that refers to a context menu link. Can be logs
, hosts
, traces
, profiles
, processes
, containers
, or rum
.
DEPRECATED: (deprecated) The attribute formerly used to group elements in the widget.
Allowed enum values: user,family,process
List of treemap widget requests.
List of formulas that operate on queries.
Define a display mode for the table cell.
Allowed enum values: number,bar
List of conditional formats.
Comparator to apply.
Allowed enum values: =,>,>=,<,<=
Color palette to apply to the background, same values available as palette.
Color palette to apply to the foreground, same values available as palette.
Displays an image as the background.
Metric from the request to correlate this conditional format with.
Color palette to apply.
Allowed enum values: blue,custom_bg,custom_image,custom_text,gray_on_white,grey,green,orange,red,red_on_white,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
Defines the displayed timeframe.
Value for the comparator.
String expression built from queries, formulas, and functions.
Options for limiting results returned.
Number of results to return.
Direction of sort.
Allowed enum values: asc,desc
default: desc
Styling options for widget formulas.
Index specifying which color to use within the palette.
The widget metrics query.
List of queries that can be returned directly or used in formulas.
A formula and functions metrics query.
The aggregation methods available for metrics queries.
Allowed enum values: avg,min,max,sum,last,area,l2norm,percentile
The source organization UUID for cross organization queries. Feature in Private Beta.
Data source for metrics queries.
Allowed enum values: metrics
Name of the query for use in formulas.
Metrics query definition.
A formula and functions events query.
Aggregation methods for event platform queries.
Allowed enum values: count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min,max,avg
A time interval in milliseconds.
Measurable attribute to compute.
The source organization UUID for cross organization queries. Feature in Private Beta.
Data source for event platform-based queries.
Allowed enum values: logs,spans,network,rum,security_signals,profiles,audit,events,ci_tests,ci_pipelines
Number of groups to return.
Options for sorting group by results.
Aggregation methods for event platform queries.
Allowed enum values: count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min,max,avg
Metric used for sorting group by results.
Direction of sort.
Allowed enum values: asc,desc
default: desc
An array of index names to query in the stream. Omit or use []
to query all indexes at once.
Name of the query for use in formulas.
Option for storage location. Feature in Private Beta.
Process query using formulas and functions.
The aggregation methods available for metrics queries.
Allowed enum values: avg,min,max,sum,last,area,l2norm,percentile
The source organization UUID for cross organization queries. Feature in Private Beta.
Data sources that rely on the process backend.
Allowed enum values: process,container
Whether to normalize the CPU percentages.
Number of hits to return.
Name of query for use in formulas.
Direction of sort.
Allowed enum values: asc,desc
default: desc
An array of tags to filter by.
A formula and functions APM dependency stats query.
The source organization UUID for cross organization queries. Feature in Private Beta.
Data source for APM dependency stats queries.
Allowed enum values: apm_dependency_stats
Determines whether stats for upstream or downstream dependencies should be queried.
Name of query to use in formulas.
operation_name [required]
Name of operation on service.
Filter APM data by the second primary tag. primary_tag_name
must also be specified.
APM statistic.
Allowed enum values: avg_duration,avg_root_duration,avg_spans_per_trace,error_rate,pct_exec_time,pct_of_traces,total_traces_count
APM resource stats query using formulas and functions.
The source organization UUID for cross organization queries. Feature in Private Beta.
Data source for APM resource stats queries.
Allowed enum values: apm_resource_stats
Array of fields to group results by.
Name of this query to use in formulas.
Name of operation on service.
Value of the second primary tag by which to filter APM data. primary_tag_name
must also be specified.
APM resource stat name.
Allowed enum values: errors,error_rate,hits,latency_avg,latency_distribution,latency_max,latency_p50,latency_p75,latency_p90,latency_p95,latency_p99
A formula and functions metrics query.
Additional filters applied to the SLO query.
The source organization UUID for cross organization queries. Feature in Private Beta.
Data source for SLO measures queries.
Allowed enum values: slo
Group mode to query measures.
Allowed enum values: overall,components
SLO measures queries.
Allowed enum values: good_events,bad_events,slo_status,error_budget_remaining,burn_rate,error_budget_burndown
Name of the query for use in formulas.
ID of an SLO to query measures.
Name of the query for use in formulas.
Allowed enum values: metric,time_slice
A formula and functions Cloud Cost query.
Aggregator used for the request.
Allowed enum values: avg,last,max,min,sum,percentile
The source organization UUID for cross organization queries. Feature in Private Beta.
Data source for Cloud Cost queries.
Allowed enum values: cloud_cost
Name of the query for use in formulas.
Query for Cloud Cost data.
Timeseries, scalar, or event list response. Event list response formats are supported by Geomap widgets.
Allowed enum values: timeseries,scalar,event_list
DEPRECATED: (deprecated) The attribute formerly used to determine size in the widget.
Allowed enum values: pct_cpu,pct_mem
Time setting for the widget.
The available timeframes depend on the widget you are using.
Allowed enum values: 1m,5m,10m,15m,30m,1h,4h,1d,2d,1w,1mo,3mo,6mo,week_to_date,month_to_date,1y,alert
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"
}
],
"group_by": "user",
"requests": [
{
"formulas": [
{
"alias": "string",
"cell_display_mode": "number",
"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"
},
"style": {
"palette": "classic",
"palette_index": 1
}
}
],
"q": "string",
"queries": [],
"response_format": "timeseries"
}
],
"size_by": "pct_cpu",
"time": {
"live_span": "5m"
},
"title": "string",
"type": "treemap"
}
円グラフウィジェット
ツリーマップウィジェットのように、円グラフウィジェットもネストされた比率を表示するために使用することができます。両者の主な違いは、円グラフは放射状のスライスで比率を表示し、ツリーマップはネストされた長方形を表示する点です。
その他の参考資料