/* * Copyright (C) 2017 The Android Open Source Project * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #pragma once #include #include #include #include "android-base/stringprintf.h" #include "FieldValue.h" #include "logd/LogEvent.h" namespace android { namespace os { namespace statsd { using ::aidl::android::os::StatsDimensionsValueParcel; // These constants must be kept in sync with those in StatsDimensionsValue.java inline constexpr int STATS_DIMENSIONS_VALUE_STRING_TYPE = 2; inline constexpr int STATS_DIMENSIONS_VALUE_INT_TYPE = 3; inline constexpr int STATS_DIMENSIONS_VALUE_LONG_TYPE = 4; // inline constexpr int STATS_DIMENSIONS_VALUE_BOOL_TYPE = 5; (commented out because // unused -- statsd does not correctly support bool types) inline constexpr int STATS_DIMENSIONS_VALUE_FLOAT_TYPE = 6; inline constexpr int STATS_DIMENSIONS_VALUE_TUPLE_TYPE = 7; struct Metric2Condition { int64_t conditionId; std::vector metricFields; std::vector conditionFields; }; struct Metric2State { int32_t stateAtomId; std::vector metricFields; std::vector stateFields; }; class HashableDimensionKey { public: explicit HashableDimensionKey(const std::vector& values) { mValues = values; } HashableDimensionKey() {}; HashableDimensionKey(const HashableDimensionKey& that) : mValues(that.getValues()){}; inline void addValue(const FieldValue& value) { mValues.push_back(value); } inline const std::vector& getValues() const { return mValues; } inline std::vector* mutableValues() { return &mValues; } inline FieldValue* mutableValue(size_t i) { if (i >= 0 && i < mValues.size()) { return &(mValues[i]); } return nullptr; } StatsDimensionsValueParcel toStatsDimensionsValueParcel() const; std::string toString() const; bool operator!=(const HashableDimensionKey& that) const; bool operator==(const HashableDimensionKey& that) const; bool operator<(const HashableDimensionKey& that) const; bool contains(const HashableDimensionKey& that) const; private: std::vector mValues; }; class MetricDimensionKey { public: explicit MetricDimensionKey(const HashableDimensionKey& dimensionKeyInWhat, const HashableDimensionKey& stateValuesKey) : mDimensionKeyInWhat(dimensionKeyInWhat), mStateValuesKey(stateValuesKey){}; MetricDimensionKey(){}; MetricDimensionKey(const MetricDimensionKey& that) : mDimensionKeyInWhat(that.getDimensionKeyInWhat()), mStateValuesKey(that.getStateValuesKey()){}; MetricDimensionKey& operator=(const MetricDimensionKey& from) = default; std::string toString() const; inline const HashableDimensionKey& getDimensionKeyInWhat() const { return mDimensionKeyInWhat; } inline const HashableDimensionKey& getStateValuesKey() const { return mStateValuesKey; } inline HashableDimensionKey* getMutableStateValuesKey() { return &mStateValuesKey; } inline void setStateValuesKey(const HashableDimensionKey& key) { mStateValuesKey = key; } bool hasStateValuesKey() const { return mStateValuesKey.getValues().size() > 0; } bool operator==(const MetricDimensionKey& that) const; bool operator<(const MetricDimensionKey& that) const; size_t getSize(const bool usesNestedDimensions) const; private: HashableDimensionKey mDimensionKeyInWhat; HashableDimensionKey mStateValuesKey; }; class AtomDimensionKey { public: explicit AtomDimensionKey(int32_t atomTag, const HashableDimensionKey& atomFieldValues) : mAtomTag(atomTag), mAtomFieldValues(atomFieldValues){}; AtomDimensionKey(){}; inline int32_t getAtomTag() const { return mAtomTag; } inline const HashableDimensionKey& getAtomFieldValues() const { return mAtomFieldValues; } bool operator==(const AtomDimensionKey& that) const; private: int32_t mAtomTag; HashableDimensionKey mAtomFieldValues; }; android::hash_t hashDimension(const HashableDimensionKey& key); /** * Returns true if a FieldValue field matches the matcher field. * This function can only be used to match one field (i.e. matcher with position ALL will return * false). The value of the FieldValue is output. */ bool filterValues(const Matcher& matcherField, const std::vector& values, FieldValue* output); /** * Creating HashableDimensionKeys from FieldValues using matcher. * * This function may make modifications to the Field if the matcher has Position=FIRST,LAST or ALL * in it. This is because: for example, when we create dimension from last uid in attribution chain, * In one event, uid 1000 is at position 5 and it's the last * In another event, uid 1000 is at position 6, and it's the last * these 2 events should be mapped to the same dimension. So we will remove the original position * from the dimension key for the uid field (by applying 0x80 bit mask). */ bool filterValues(const std::vector& matcherFields, const std::vector& values, HashableDimensionKey* output); /** * Filters FieldValues to create HashableDimensionKey using dimensions matcher fields and create * vector of value indices using values matcher fields. * * This function may make modifications to the Field if the matcher has Position=FIRST,LAST or ALL * in it. This is because: for example, when we create dimension from last uid in attribution chain, * In one event, uid 1000 is at position 5 and it's the last * In another event, uid 1000 is at position 6, and it's the last * these 2 events should be mapped to the same dimension. So we will remove the original position * from the dimension key for the uid field (by applying 0x80 bit mask). * * dimKeyMatcherFields: the matchers for each dimension field * valueMatcherFields: the matchers for each value field * values: FieldValues being filtered by the matchers * key: HashableDimensionKey containing the values filtered by the dimKeyMatcherFields * valueIndices: index position of each matched FieldValue corresponding to the valueMatcherFields */ bool filterValues(const std::vector& dimKeyMatcherFields, const std::vector& valueMatcherFields, const std::vector& values, HashableDimensionKey& key, std::vector& valueIndices); /** * Creating HashableDimensionKeys from State Primary Keys in FieldValues. * * This function may make modifications to the Field if the matcher has Position=FIRST,LAST or ALL * in it. This is because: for example, when we create dimension from last uid in attribution chain, * In one event, uid 1000 is at position 5 and it's the last * In another event, uid 1000 is at position 6, and it's the last * these 2 events should be mapped to the same dimension. So we will remove the original position * from the dimension key for the uid field (by applying 0x80 bit mask). */ bool filterPrimaryKey(const std::vector& values, HashableDimensionKey* output); /** * Filter the values from FieldValues using the matchers. * * In contrast to the above function, this function will not do any modification to the original * data. Considering it as taking a snapshot on the atom event. */ void filterGaugeValues(const std::vector& matchers, const std::vector& values, std::vector* output); void getDimensionForCondition(const std::vector& eventValues, const Metric2Condition& links, HashableDimensionKey* conditionDimension); /** * Get dimension values using metric's "what" fields and fill statePrimaryKey's * mField information using "state" fields. */ void getDimensionForState(const std::vector& eventValues, const Metric2State& link, HashableDimensionKey* statePrimaryKey); /** * Returns true if the primaryKey values are a subset of the whatKey values. * The values from the primaryKey come from the state atom, so we need to * check that a link exists between the state atom field and what atom field. * * Example: * whatKey = [Atom: 10, {uid: 1005, wakelock_name: "compose"}] * statePrimaryKey = [Atom: 27, {uid: 1005}] * Returns true IF one of the Metric2State links Atom 10's uid to Atom 27's uid * * Example: * whatKey = [Atom: 10, {uid: 1005, wakelock_name: "compose"}] * statePrimaryKey = [Atom: 59, {uid: 1005, package_name: "system"}] * Returns false */ bool containsLinkedStateValues(const HashableDimensionKey& whatKey, const HashableDimensionKey& primaryKey, const std::vector& stateLinks, const int32_t stateAtomId); /** * Returns true if there is a Metric2State link that links the stateField and * the metricField (they are equal fields from different atoms). */ bool linked(const std::vector& stateLinks, const int32_t stateAtomId, const Field& stateField, const Field& metricField); } // namespace statsd } // namespace os } // namespace android template <> struct std::hash { std::size_t operator()(const android::os::statsd::HashableDimensionKey& key) const { return hashDimension(key); } }; template <> struct std::hash { std::size_t operator()(const android::os::statsd::MetricDimensionKey& key) const { android::hash_t hash = hashDimension(key.getDimensionKeyInWhat()); hash = android::JenkinsHashMix(hash, hashDimension(key.getStateValuesKey())); return android::JenkinsHashWhiten(hash); } }; template <> struct std::hash { std::size_t operator()(const android::os::statsd::AtomDimensionKey& key) const { android::hash_t hash = hashDimension(key.getAtomFieldValues()); hash = android::JenkinsHashMix(hash, key.getAtomTag()); return android::JenkinsHashWhiten(hash); } };