engage-engine 1.251.90910028 → 1.252.90920030

package/include/ConfigurationObjects.h

@@ -8321,6 +8321,88 @@ namespace AppConfigurationObjects
     }
 
 
+    //-----------------------------------------------------------
+    JSON_SERIALIZED_CLASS(RallypointServerStreamStatsExport)
+    /**
+    * Helper C++ class to serialize and de-serialize RallypointServerStreamStatsExport JSON
+    *
+    * Example: @include[doc] examples/RallypointServerStreamStatsExport.json
+    *
+    * @see RallypointServer
+    */
+    class RallypointServerStreamStatsExport : public ConfigurationObjectBase
+    {
+        IMPLEMENT_JSON_SERIALIZATION()
+        IMPLEMENT_JSON_DOCUMENTATION(RallypointServerStreamStatsExport)
+
+    public:
+        /** @brief Enum describing format(s) for the stream stats export. */
+        typedef enum
+        {
+            /** @brief Data in CSV format */
+            fmtCsv   = 0,
+
+            /** @brief Data in JSON format */
+            fmtJson = 1
+        } ExportFormat_t;
+
+        /** File name to use for the stream stats export. */
+        std::string                     fileName;
+
+        /** [Optional, Default: 60] The interval at which to export stream stats. */
+        int                             intervalSecs;
+
+        /** [Optional, Default: false] Indicates if stream stats export is enabled. */
+        bool                            enabled;
+
+        /** [Optional, Default: false] Whether to reset counters after export. */
+        bool                            resetCountersAfterExport;
+
+        /** [Optional, Default: null] Command to be executed every time the stream stats export is produced. */
+        std::string                     runCmd;
+
+        /** [Optional, Default: fmtCsv] Format for the stream stats export. */
+        ExportFormat_t                  format;
+
+
+        RallypointServerStreamStatsExport()
+        {
+            clear();
+        }
+
+        void clear()
+        {
+            fileName.clear();
+            intervalSecs = 60;
+            enabled = false;
+            resetCountersAfterExport = false;
+            runCmd.clear();
+            format = fmtJson;
+        }
+    };
+
+    static void to_json(nlohmann::json& j, const RallypointServerStreamStatsExport& p)
+    {
+        j = nlohmann::json{
+            TOJSON_IMPL(fileName),
+            TOJSON_IMPL(intervalSecs),
+            TOJSON_IMPL(enabled),
+            TOJSON_IMPL(resetCountersAfterExport),
+            TOJSON_IMPL(runCmd),
+            TOJSON_IMPL(format)
+        };
+    }
+    static void from_json(const nlohmann::json& j, RallypointServerStreamStatsExport& p)
+    {
+        p.clear();
+        getOptional<std::string>("fileName", p.fileName, j);
+        getOptional<int>("intervalSecs", p.intervalSecs, j, 60);
+        getOptional<bool>("enabled", p.enabled, j, false);
+        getOptional<bool>("resetCountersAfterExport", p.resetCountersAfterExport, j, false);
+        getOptional<std::string>("runCmd", p.runCmd, j);
+        getOptional<RallypointServerStreamStatsExport::ExportFormat_t>("format", p.format, j, RallypointServerStreamStatsExport::ExportFormat_t::fmtCsv);
+    }
+
     //-----------------------------------------------------------
     JSON_SERIALIZED_CLASS(RallypointServerRouteMap)
     class RallypointServerRouteMap : public ConfigurationObjectBase
@@ -9255,6 +9337,9 @@ namespace AppConfigurationObjects
         /** @brief Details for producing a report containing the route map. @see RallypointServerRouteMap */
         RallypointServerRouteMap                    routeMap;
 
+        /** @brief Details for exporting stream statistics. @see RallypointServerStreamStatsExport */
+        RallypointServerStreamStatsExport           streamStatsExport;
+
         /** @brief [Optional, Default 15] Sets the delta value for the maximum number of seconds to delay when attempting outbound peer connections */
         uint32_t                                    maxOutboundPeerConnectionIntervalDeltaSecs;
 
@@ -9346,6 +9431,7 @@ namespace AppConfigurationObjects
             disableLoopDetection = false;
             maxSecurityLevel = 0;
             routeMap.clear();
+            streamStatsExport.clear();
             maxOutboundPeerConnectionIntervalDeltaSecs = 15;
             peerRtTestIntervalMs = 60000;
             peerRtBehaviors.clear();
@@ -9412,6 +9498,7 @@ namespace AppConfigurationObjects
             TOJSON_IMPL(disableLoopDetection),
             TOJSON_IMPL(maxSecurityLevel),
             TOJSON_IMPL(routeMap),
+            TOJSON_IMPL(streamStatsExport),
             TOJSON_IMPL(maxOutboundPeerConnectionIntervalDeltaSecs),
             TOJSON_IMPL(peerRtTestIntervalMs),
             TOJSON_IMPL(peerRtBehaviors),
@@ -9477,6 +9564,7 @@ namespace AppConfigurationObjects
         getOptional<bool>("disableLoopDetection", p.disableLoopDetection, j, false);
         getOptional<uint32_t>("maxSecurityLevel", p.maxSecurityLevel, j, 0);
         getOptional<RallypointServerRouteMap>("routeMap", p.routeMap, j);
+        getOptional<RallypointServerStreamStatsExport>("streamStatsExport", p.streamStatsExport, j);
         getOptional<uint32_t>("maxOutboundPeerConnectionIntervalDeltaSecs", p.maxOutboundPeerConnectionIntervalDeltaSecs, j, 15);        
         getOptional<int>("peerRtTestIntervalMs", p.peerRtTestIntervalMs, j, 60000);
         getOptional<std::vector<RallypointRpRtTimingBehavior>>("peerRtBehaviors", p.peerRtBehaviors, j);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "engage-engine",
-  "version": "1.251.90910028",
+  "version": "1.252.90920030",
   "description": "Use Engage to communicate with everyone, everywhere, from any device",
   "scripts": {
     "test": "echo \"Error: no test specified\" && exit 1"