// // Copyright (c) 2014-2016 THUNDERBEAST GAMES LLC // // Permission is hereby granted, free of charge, to any person obtaining a copy // of this software and associated documentation files (the "Software"), to deal // in the Software without restriction, including without limitation the rights // to use, copy, modify, merge, publish, distribute, sublicense, and/or sell // copies of the Software, and to permit persons to whom the Software is // furnished to do so, subject to the following conditions: // // The above copyright notice and this permission notice shall be included in // all copies or substantial portions of the Software. // // THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR // IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, // FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE // AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER // LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, // OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN // THE SOFTWARE. // #pragma once #include "../Core/Object.h" #include "../Container/List.h" namespace Atomic { class ATOMIC_API MetricsSnapshot : public RefCounted { friend class Metrics; ATOMIC_REFCOUNTED(MetricsSnapshot) public: MetricsSnapshot() {} String PrintData(unsigned columns = 1, unsigned minCount = 0); void Clear(); /// Register instance(s) of classname in metrics snapshot void RegisterInstance(const String& classname, InstantiationType instantiationType, int count = 1); private: struct InstanceMetric { String classname; unsigned count; unsigned nativeInstances; unsigned jsInstances; unsigned netInstances; InstanceMetric() { count = nativeInstances = jsInstances = netInstances = 0; } }; struct NodeMetric { String name; unsigned count; NodeMetric() { count = 0; } }; struct ResourceMetric { String name; String group; unsigned memoryUsage; ResourceMetric() { memoryUsage = 0; } }; static bool CompareInstanceMetrics(const InstanceMetric& lhs, const InstanceMetric& rhs); // StringHash(classname) => InstanceMetrics HashMap instanceMetrics_; // StringHash(node name) => NodeMetrics HashMap nodeMetrics_; // StringHash(resource name) => ResourceMetrics HashMap resourceMetrics_; }; /// Metrics subsystem class ATOMIC_API Metrics : public Object { friend class Application; ATOMIC_OBJECT(Metrics, Object) public: /// Construct. Metrics(Context* context); /// Destruct. virtual ~Metrics(); /// Enable the Metrics subsystem and start capturing instance data, expensive on CPU and may cause stuttering while enabled bool Enable(); /// Get whether the Metrics subsystem is enabled or not bool GetEnabled() const { return enabled_; } // Captures a snapshot of metrics data void Capture(MetricsSnapshot* snapshot); /// Prints names of registered node instances output string String PrintNodeNames() const; private: // A RefCountedInfo entry, necessary as we need to access instances in RefCounted constructor/destructor // and info is not available (pure call access violations on abstract virtual functions) struct RefCountedInfo { // pointer to corresponding RefCounted, null means a free entry RefCounted *refCounted; // the has of the typename StringHash typeID; // for some types, like ScriptComponent it is useful to override the name to the JSComponent/CSComponent StringHash typeNameOverride; // the instantiation type of the instance InstantiationType instantiationType; }; void Disable(); void CaptureInstances(MetricsSnapshot* snapshot); void ProcessInstances(); static void OnRefCountedCreated(RefCounted* refCounted); static void OnRefCountedDeleted(RefCounted* refCounted); void AddRefCounted(RefCounted* refCounted); void RemoveRefCounted(RefCounted* refCounted); // static instance static Metrics* metrics_; static bool everEnabled_; bool enabled_; // typeid -> information for individual RefCounted mutable HashMap> instances_; // instances added since last capture, see note on RefCountedInfo as to why necessary PODVector processInstances_; // Lookup from string hashes to avoid String thrashing in the metrics subsystem with large numbers of instances HashMap names_; }; }