Glossary Of Terms

Owned by Teresa Rael (Unlicensed)
Last updated: Apr 18, 2016
3 min read
  • CEP - Complex Event Processing, a method of tracking and processing streams of data pertaining to events, deriving conclusions and responding as quickly as possible.

  • Pub / Sub System = Publish / Subscribe System. Cogs is a topic-based system where messages are published to "topics" or named logical channels. Subscribers in a topic-based system will receive all messages published to the topics to which they subscribe, and all subscribers to a topic will receive the same messages. The publisher is responsible for defining the classes of messages to which subscribers can subscribe.
    • Subscriber or Subscription - Message receiver, subscribers express interest in one or more classes of messages.
    • Topics - Named logical channel.

  • API Key – Security key used to authenticate the incoming data to Cogs.
    • Access Key - This is the key that is embed in your application. 
    • Secret Key - This is used to authenticate events containing the associated Access Key. The Secret Key component of your API Keys should remain completely secret and secure in your internal systems and should NEVER be deployed into any client apps.
    • Client Keys - Client Keys are derived from API Keys, and it is these Client Keys, not the API Keys, which should be deployed in those apps/devices which use the Cogswell API. Client Keys are limited to those actions to which clients should be limited: sending events, establishing push WebSockets, etc.
      • Client Salt - The Client Salt is a random sequence of bytes.
      • Client Secret - Generated from the Client Salt in combination with the associated API Key's Secret Key.

  • Event – Data being transmitted by a product/app to Cogs.

  • Segment – A subset of data or attributes.

  • Attribute – A characteristic of data (fields collected).
    • Core Attribute - An Attribute that will always be added to Namespaces.
    • Namespace Attribute - An Attribute created for a specific Namespace.
    • Primary Key – Attribute(s) that uniquely identifies the individual device sending information to Cogs.
    • Date Type - Describes the data in an Attribute (Integer, Text, Float, Date, Boolean).

  • Namespace – Top-line grouping of end-user products.
    • Namespace Segment – A segment applied to a namespace.
      • Rules – Client defined business rules that are applied to incoming event data to evaluate what actions are to be taken.
        • Event Filters - Evaluate incoming data based on a specific set of events or a specific time frame.
        • Attribute Filters - Evaluate incoming data based on a specific value or range of an Attribute  .
        • Conditions - Evaluate incoming data based on an Attribute metric that must return a value of true.
    • Namespace Attributes – The set of relevant data characteristics of a namespace.

    • Campaign – Defines the content, the audience and the rules by which messages are delivered.
      • URL / No URL - The user will define how their client app will interpret the URL to take an action.
      • JSON Payload - The user will define how their client app will interpret the JSON to take an action.
      • Rules – Client defined business rules that are applied to incoming event data to evaluate what actions are to be taken.

    • Export – Mechanism for clients to retrieve their event data.

  • Mobile App - This is the users client app that interfaces with Cogs.  The Cogs Mobile Application page is where the user will defines the mobile environment. 
    • Cert File / Password - An APNS certificate and password created when a user creates an iOS app to interface with Cogs.
    • Android API Key - API Key created when a user creates an Android app to interface with Cogs.