OpenMAMA
 All Data Structures Files Functions Variables Typedefs Enumerations Enumerator Macros Pages
statslogger.h File Reference
#include <mama/status.h>
#include <mama/types.h>

Go to the source code of this file.

Macros

#define SL_TOPIC_USAGE_LOG   "SL_TOPIC_USAGE_LOG"
#define STATS_TOPIC   "STATS_TOPIC"

Typedefs

typedef enum mamaSlEvent_ mamaSlEvent
 The event types handled by the stats logger.
typedef enum mamaSlSubFailReason_ mamaSlSubFailReason
 The reasons for a subscription to fail.

Enumerations

enum  mamaSlEvent_ {
  MAMA_SL_EVENT_LOGIN = 0, MAMA_SL_EVENT_LOGOUT = 1, MAMA_SL_EVENT_SUB_CREATE = 2, MAMA_SL_EVENT_SUB_FAIL = 3,
  MAMA_SL_EVENT_SUB_DESTROY = 4, MAMA_SL_EVENT_SUB_ENT_PASS = 5
}
 The event types handled by the stats logger. More...
enum  mamaSlSubFailReason_ { MAMA_SL_SUB_FAIL_REGEX = 0, MAMA_SL_SUB_FAIL_CODE = 1, MAMA_SL_SUB_FAIL_TIMEOUT = 2, MAMA_SL_SUB_FAIL_NOT_FOUND = 3 }
 The reasons for a subscription to fail. More...

Functions

MAMAExpDLL const char * mamaStatsLogger_eventToString (mamaSlEvent event)
 Convert a mamaSlEvent value to a string.
MAMAExpDLL const char * mamaStatsLogger_subFailReasonToString (mamaSlSubFailReason subFailReason)
 Convert a mamaSlSubFailReason value to a string.
MAMAExpDLL mama_status mamaStatsLogger_allocate (mamaStatsLogger *logger)
 Allocate memory for a new stats logger.
MAMAExpDLL mama_status mamaStatsLogger_create (mamaStatsLogger logger, mamaQueue queue, mamaTransport tport)
 Create and activate mamaStatsLogger object.
MAMAExpDLL mama_status mamaStatsLogger_createForStats (mamaStatsLogger logger, mamaQueue queue, mamaTransport tport, const char *topic)
MAMAExpDLL mama_status mamaStatsLogger_destroy (mamaStatsLogger logger)
 Destroy a mamaStatsLogger object, freeing any memory.
MAMAExpDLL mama_status mamaStatsLogger_setReportInterval (mamaStatsLogger logger, mama_f64_t interval)
 Set the reporting interval.
MAMAExpDLL mama_status mamaStatsLogger_setReportSize (mamaStatsLogger logger, mama_size_t numEvents)
 Set the maximum number of events to cache before reporting.
MAMAExpDLL mama_status mamaStatsLogger_setUserName (mamaStatsLogger logger, const char *userName)
 Set the userName.
MAMAExpDLL mama_status mamaStatsLogger_getUserName (const mamaStatsLogger logger, const char **userName)
 Get the userName.
MAMAExpDLL mama_status mamaStatsLogger_setHostName (mamaStatsLogger logger, const char *hostName)
 Set the hostName.
MAMAExpDLL mama_status mamaStatsLogger_getHostName (const mamaStatsLogger logger, const char **hostName)
 Get the hostName.
MAMAExpDLL mama_status mamaStatsLogger_setApplicationName (mamaStatsLogger logger, const char *appName)
 Set the applicationName.
MAMAExpDLL mama_status mamaStatsLogger_getApplicationName (const mamaStatsLogger logger, const char **appName)
 Get the applicationName.
MAMAExpDLL mama_status mamaStatsLogger_setApplicationClass (mamaStatsLogger logger, const char *applClass)
 Set the applicationClass.
MAMAExpDLL mama_status mamaStatsLogger_getApplicationClass (const mamaStatsLogger logger, const char **appClass)
 Get the applicationClass.
MAMAExpDLL mama_status mamaStatsLogger_setIpAddress (mamaStatsLogger logger, const char *ipAddress)
 Set the ipAddress.
MAMAExpDLL mama_status mamaStatsLogger_getIpAddress (const mamaStatsLogger logger, const char **ipAddress)
 Get the ipAddress.
MAMAExpDLL mama_status mamaStatsLogger_logLogin (mamaStatsLogger logger)
 Log a login event.
MAMAExpDLL mama_status mamaStatsLogger_logLogout (mamaStatsLogger logger)
 Log a logout event.
MAMAExpDLL mama_status mamaStatsLogger_logSubscriptionEntitlePass (mamaStatsLogger logger, mamaSubscription subscription, int32_t entitleCode)
 Log a subscription entitlement check pass event.
MAMAExpDLL mama_status mamaStatsLogger_logSubscriptionFail (mamaStatsLogger logger, mamaSubscription subscription, mamaSlSubFailReason reason)
 Log a subscription fail event.
MAMAExpDLL mama_status mamaStatsLogger_logSubscriptionDestroy (mamaStatsLogger logger, mamaSubscription subscription)
 Log a subscription destroy event.
MAMAExpDLL mama_status mamaStatsLogger_addStatMsg (mamaStatsLogger *logger, mamaMsg msg)
MAMAExpDLL mama_status mamaStatsLogger_sendReport (mamaStatsLogger *logger)
MAMAExpDLL mama_status mamaStatsLogger_getLogMsgStats (mamaStatsLogger logger, mama_bool_t *logMsgStats)
MAMAExpDLL mama_status mamaStatsLogger_setLogMsgStats (mamaStatsLogger logger, mama_bool_t logMsgStats)
MAMAExpDLL mama_status mamaStatsLogger_incMsgCount (mamaStatsLogger statsLogger)

Macro Definition Documentation

#define SL_TOPIC_USAGE_LOG   "SL_TOPIC_USAGE_LOG"
#define STATS_TOPIC   "STATS_TOPIC"

Typedef Documentation

typedef enum mamaSlEvent_ mamaSlEvent

The event types handled by the stats logger.

The reasons for a subscription to fail.

Enumeration Type Documentation

The event types handled by the stats logger.

Enumerator:
MAMA_SL_EVENT_LOGIN 
MAMA_SL_EVENT_LOGOUT 
MAMA_SL_EVENT_SUB_CREATE 
MAMA_SL_EVENT_SUB_FAIL 
MAMA_SL_EVENT_SUB_DESTROY 
MAMA_SL_EVENT_SUB_ENT_PASS 

The reasons for a subscription to fail.

Enumerator:
MAMA_SL_SUB_FAIL_REGEX 
MAMA_SL_SUB_FAIL_CODE 
MAMA_SL_SUB_FAIL_TIMEOUT 
MAMA_SL_SUB_FAIL_NOT_FOUND 

Function Documentation

MAMAExpDLL const char* mamaStatsLogger_eventToString ( mamaSlEvent  event)

Convert a mamaSlEvent value to a string.

Do no attempt to free the string result.

Parameters
eventThe mamaSlEvent to convert.
MAMAExpDLL const char* mamaStatsLogger_subFailReasonToString ( mamaSlSubFailReason  subFailReason)

Convert a mamaSlSubFailReason value to a string.

Do no attempt to free the string result.

Parameters
subFailReasonThe mamaSlSubFailReason to convert.
MAMAExpDLL mama_status mamaStatsLogger_allocate ( mamaStatsLogger logger)

Allocate memory for a new stats logger.

The logger is not actually created until a call the create() functions is made. Memory must be freed using the mamaStatsLogger_Deallocate() function.

Parameters
loggerWhere the address of the new logger will be written
MAMAExpDLL mama_status mamaStatsLogger_create ( mamaStatsLogger  logger,
mamaQueue  queue,
mamaTransport  tport 
)

Create and activate mamaStatsLogger object.

Parameters
loggerThe location of a mamaStatsLogger
queueThe queue for the Stats Logger to use for publishing
tportthe transport
MAMAExpDLL mama_status mamaStatsLogger_createForStats ( mamaStatsLogger  logger,
mamaQueue  queue,
mamaTransport  tport,
const char *  topic 
)
MAMAExpDLL mama_status mamaStatsLogger_destroy ( mamaStatsLogger  logger)

Destroy a mamaStatsLogger object, freeing any memory.

Parameters
loggerThe location of a mamaStatsLogger
MAMAExpDLL mama_status mamaStatsLogger_setReportInterval ( mamaStatsLogger  logger,
mama_f64_t  interval 
)

Set the reporting interval.

Parameters
loggerThe location of a mamaStatsLogger
intervalThe report interval in seconds
MAMAExpDLL mama_status mamaStatsLogger_setReportSize ( mamaStatsLogger  logger,
mama_size_t  numEvents 
)

Set the maximum number of events to cache before reporting.

Parameters
loggerThe location of a mamaStatsLogger
numEventsThe number of events to report after
MAMAExpDLL mama_status mamaStatsLogger_setUserName ( mamaStatsLogger  logger,
const char *  userName 
)

Set the userName.

Parameters
loggerThe logger object to update.
userNameThe user name for the logger
MAMAExpDLL mama_status mamaStatsLogger_getUserName ( const mamaStatsLogger  logger,
const char **  userName 
)

Get the userName.

Parameters
loggerThe logger object to check.
userNameLocation of the result for the description of the logger.
MAMAExpDLL mama_status mamaStatsLogger_setHostName ( mamaStatsLogger  logger,
const char *  hostName 
)

Set the hostName.

Parameters
loggerThe logger object to update.
hostNameThe host name for the logger
MAMAExpDLL mama_status mamaStatsLogger_getHostName ( const mamaStatsLogger  logger,
const char **  hostName 
)

Get the hostName.

Parameters
loggerThe logger object to check.
hostNameLocation of the result for the description of the logger.
MAMAExpDLL mama_status mamaStatsLogger_setApplicationName ( mamaStatsLogger  logger,
const char *  appName 
)

Set the applicationName.

Parameters
loggerThe logger object to update.
appNameThe applicationName for the logger
MAMAExpDLL mama_status mamaStatsLogger_getApplicationName ( const mamaStatsLogger  logger,
const char **  appName 
)

Get the applicationName.

Parameters
loggerThe logger object to check.
appNameLocation of the result for the applicationName
MAMAExpDLL mama_status mamaStatsLogger_setApplicationClass ( mamaStatsLogger  logger,
const char *  applClass 
)

Set the applicationClass.

Parameters
loggerThe logger object to update.
applClassThe applicationName for the logger
MAMAExpDLL mama_status mamaStatsLogger_getApplicationClass ( const mamaStatsLogger  logger,
const char **  appClass 
)

Get the applicationClass.

Parameters
loggerThe logger object to check.
appClassLocation of the result for the applicationClass
MAMAExpDLL mama_status mamaStatsLogger_setIpAddress ( mamaStatsLogger  logger,
const char *  ipAddress 
)

Set the ipAddress.

Parameters
loggerThe logger object to update.
ipAddressThe ipAddress for the logger
MAMAExpDLL mama_status mamaStatsLogger_getIpAddress ( const mamaStatsLogger  logger,
const char **  ipAddress 
)

Get the ipAddress.

Parameters
loggerThe logger object to check.
ipAddressLocation of the result for the ipAddress of the logger.
MAMAExpDLL mama_status mamaStatsLogger_logLogin ( mamaStatsLogger  logger)

Log a login event.

Parameters
loggerThe logger object to use.
MAMAExpDLL mama_status mamaStatsLogger_logLogout ( mamaStatsLogger  logger)

Log a logout event.

Parameters
loggerThe logger object to use.
MAMAExpDLL mama_status mamaStatsLogger_logSubscriptionEntitlePass ( mamaStatsLogger  logger,
mamaSubscription  subscription,
int32_t  entitleCode 
)

Log a subscription entitlement check pass event.

Parameters
loggerThe logger object to use.
subscriptionthe subscription
entitleCodethe entitlement code
MAMAExpDLL mama_status mamaStatsLogger_logSubscriptionFail ( mamaStatsLogger  logger,
mamaSubscription  subscription,
mamaSlSubFailReason  reason 
)

Log a subscription fail event.

Parameters
loggerThe logger object to use.
subscriptionthe subscription
reasonthe reason
MAMAExpDLL mama_status mamaStatsLogger_logSubscriptionDestroy ( mamaStatsLogger  logger,
mamaSubscription  subscription 
)

Log a subscription destroy event.

Parameters
loggerThe logger object to use.
subscriptionthe subscription
MAMAExpDLL mama_status mamaStatsLogger_addStatMsg ( mamaStatsLogger logger,
mamaMsg  msg 
)
MAMAExpDLL mama_status mamaStatsLogger_sendReport ( mamaStatsLogger logger)
MAMAExpDLL mama_status mamaStatsLogger_getLogMsgStats ( mamaStatsLogger  logger,
mama_bool_t logMsgStats 
)
MAMAExpDLL mama_status mamaStatsLogger_setLogMsgStats ( mamaStatsLogger  logger,
mama_bool_t  logMsgStats 
)
MAMAExpDLL mama_status mamaStatsLogger_incMsgCount ( mamaStatsLogger  statsLogger)


© 2012 Linux Foundation