1
0
Fork 0
arangodb/Documentation/DocuBlocks/Rest/Administration/get_admin_statistics_descri...

2.7 KiB

@startDocuBlock get_admin_statistics_description @brief fetch descriptive info of statistics

@RESTHEADER{GET /_admin/statistics-description, Statistics description, getStatisticsDescription}

@RESTDESCRIPTION Returns a description of the statistics returned by /_admin/statistics. The returned objects contains an array of statistics groups in the attribute groups and an array of statistics figures in the attribute figures.

A statistics group is described by

  • group: The identifier of the group.
  • name: The name of the group.
  • description: A description of the group.

A statistics figure is described by

  • group: The identifier of the group to which this figure belongs.
  • identifier: The identifier of the figure. It is unique within the group.
  • name: The name of the figure.
  • description: A description of the figure.
  • type: Either current, accumulated, or distribution.
  • cuts: The distribution vector.
  • units: Units in which the figure is measured.

@RESTRETURNCODES

@RESTRETURNCODE{200} Description was returned successfully.

@RESTREPLYBODY{groups,array,required,admin_statistics_group_struct} A statistics group

@RESTSTRUCT{group,admin_statistics_group_struct,string,required,} The identifier of the group.

@RESTSTRUCT{name,admin_statistics_group_struct,string,required,} The name of the group.

@RESTSTRUCT{description,admin_statistics_group_struct,string,required,} A description of the group.

@RESTREPLYBODY{figures,array,required,admin_statistics_figures_struct} A statistics figure

@RESTSTRUCT{group,admin_statistics_figures_struct,string,required,} The identifier of the group to which this figure belongs.

@RESTSTRUCT{identifier,admin_statistics_figures_struct,string,required,} The identifier of the figure. It is unique within the group.

@RESTSTRUCT{name,admin_statistics_figures_struct,string,required,} The name of the figure.

@RESTSTRUCT{description,admin_statistics_figures_struct,string,required,} A description of the figure.

@RESTSTRUCT{type,admin_statistics_figures_struct,string,required,} Either current, accumulated, or distribution.

@RESTSTRUCT{cuts,admin_statistics_figures_struct,string,required,} The distribution vector.

@RESTSTRUCT{units,admin_statistics_figures_struct,string,required,} Units in which the figure is measured.

@RESTREPLYBODY{code,integer,required,int64} the HTTP status code

@RESTREPLYBODY{error,boolean,required,} the error, false in this case

@EXAMPLES

@EXAMPLE_ARANGOSH_RUN{RestAdminStatisticsDescription1} var url = "/_admin/statistics-description"; var response = logCurlRequest('GET', url);

assert(response.code === 200);

logJsonResponse(response);

@END_EXAMPLE_ARANGOSH_RUN @endDocuBlock