Get Corrade Heartbeat Data

7 October 2016

  • Release 9.134 - added.
getheartbeatdata (Commands)
TypeCorrade progressive command
Commandgetheartbeatdata
DescriptionThe getheartbeatdata command can query Corrade's heartbeat data.
Permissionsgrooming
Parametersgroup, password, data
Last ChangesRelease 9.134 - added.

The getheartbeatdata command can query Corrade's heartbeat data.

Command Required Parameters Required Corrade Permissions Example
getheartbeatdata group, password, data grooming
llInstantMessage(CORRADE,
    wasKeyValueEncode(
        [
            // get the average CPU and RAM usage
            "command", "getheartbeatdata",
            "group", wasURLEscape(GROUP),
            "password", wasURLEscape(PASSWORD),
            "data", wasListToCSV(
                [
                    "AverageCPUUsage",
                    "AverageRAMUsage"
                ]
            ),
            "callback", wasURLEscape(URL)
        ]
    )
);

Corrade heartbeats have a one minute periodicity meaning that the averages are computed cumulatively over 1 minute intervals.

Structure

/// <summary>
///     Heartbeat Structure.
/// </summary>
public class Heartbeat
{
    /// <summary>
    ///     The number of currently executing Corrade commands.
    /// </summary>
    public int ExecutingCommands;
 
    /// <summary>
    ///     The number of currently executing RLV behaviours.
    /// </summary>
    public int ExecutingRLVBehaviours;
 
    /// <summary>
    ///     The total number of processed Corrade commands.
    /// </summary>
    public int ProcessedCommands;
 
    /// <summary>
    ///     The total number of processed RLV behaviours.
    /// </summary>
    public int ProcessedRLVBehaviours;
 
    /// <summary>
    ///     The process start time.
    /// </summary>
    public DateTime StartTime;
 
    /// <summary>
    ///     The artihmetic average of all CPU usages accross all heartbeats.
    /// </summary>
    public uint AverageCPUUsage;
 
    /// <summary>
    ///     The arithmetic average of all RAM usages across all heartbeats.
    /// </summary>
    public long AverageRAMUsage;
 
    /// <summary>
    ///     The total number of heartbeats.
    /// </summary>
    public uint Heartbeats;
 
    /// <summary>
    ///     The uptime of the current Corrade instance (updated in heartbeat intervals).
    /// </summary>
    public ulong Uptime;
 
    /// <summary>
    ///     Corrade version.
    /// </summary>
    public string Version;
}

secondlife/scripted_agents/corrade/api/progressive/commands/getheartbeatdata.txt ยท Last modified: 2017/02/22 18:27 (external edit)

Access website using Tor


For the copyright, license, warranty and privacy terms for the usage of this website please see the license and privacy pages.