blob: c7df43d89cbb1e92cd72d5d1df11c1fa7c1e3b6d (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
|
// -*- mode: C++ -*-
// AUTOGENERATED BY glean_parser. DO NOT EDIT.
{# The rendered source is autogenerated, but this
Jinja2 template is not. Please file bugs! #}
/* This Source Code Form is subject to the terms of the Mozilla Public
* License, v. 2.0. If a copy of the MPL was not distributed with this
* file, You can obtain one at http://mozilla.org/MPL/2.0/. */
#ifndef mozilla_GleanJSMetricsLookup_h
#define mozilla_GleanJSMetricsLookup_h
#include <cstdint>
#include "mozilla/AlreadyAddRefed.h"
#include "mozilla/Maybe.h"
#include "nsStringFwd.h"
class nsISupports;
namespace mozilla::glean {
// The category lookup table's entry type
using category_entry_t = uint32_t;
// The metric lookup table's entry type
// This is a bitpacked type with {{index_bits}} bits available to index into
// the string table, {{type_bits}} bits available to signify the metric type,
// and the remaining {{id_bits}} bits devoted to {{id_signal_bits}} "signal"
// bits to signify important characteristics (metric's a labeled metric's
// submetric, metric's been registered at runtime) and {{id_bits - id_signal_bits}} bits
// for built-in metric ids.
// Gives room for {{2 ** (id_bits - id_signal_bits)}} of each combination of
// characteristics (which hopefully will prove to be enough).
using metric_entry_t = uint64_t;
already_AddRefed<nsISupports> NewMetricFromId(uint32_t id);
/**
* Create a submetric instance for a labeled metric of the provided type and id for the given label.
* Assigns or retrieves an id for the submetric from the SDK.
*
* @param aParentTypeId - The type of the parent labeled metric identified as a number generated during codegen.
* Only used to identify which X of LabeledX you are so that X can be created here.
* @param aParentMetricId - The metric id for the parent labeled metric.
* @param aLabel - The label for the submetric. Might not adhere to the SDK label format.
* @param aSubmetricId - an outparam which is assigned the submetric's SDK-generated submetric id.
* Used only by GIFFT.
*/
already_AddRefed<nsISupports> NewSubMetricFromIds(uint32_t aParentTypeId, uint32_t aParentMetricId, const nsACString& aLabel, uint32_t* aSubmetricId);
/**
* Get a category's name from the string table.
*/
const char* GetCategoryName(category_entry_t entry);
/**
* Get a metric's identifier from the string table.
*/
const char* GetMetricIdentifier(metric_entry_t entry);
/**
* Get a metric's id given its name.
*/
Maybe<uint32_t> MetricByNameLookup(const nsACString&);
/**
* Get a category's id given its name.
*/
Maybe<uint32_t> CategoryByNameLookup(const nsACString&);
extern const category_entry_t sCategoryByNameLookupEntries[{{num_categories}}];
extern const metric_entry_t sMetricByNameLookupEntries[{{num_metrics}}];
} // namespace mozilla::glean
#endif // mozilla_GleanJSMetricsLookup_h
|
