Streams and Tags

Medium One accepts data in the JSON format. Below are some examples of the correct JSON data format:

  • Example 1: Sending in one event with one tag

    {"observed_at": "2016-02-16T15:14:08-08:00","event_data": {"tag_name":"string_data"}}
  • Example 2: Sending in one event with two tags

    {"observed_at": "2016-02-16T15:14:08-08:00","event_data": {"tag_name1":"string_data", "tag_name2":100}}
  • Example 3: Including add_client_ip
    {"observed_at": "2016-02-16T15:14:08-08:00", "event_data": {"tag_name1":"string_data"}, "add_client_ip":true}

 

The fields are:

  • observed_at (optional) : This field is the time that the data is observed. It is in ISO8601-formatted text string. If this field is not sent in the JSON, the received at timestamp will be used.
    • Example: "2014-07-25T12:12:56.2345-08:00"
  • add_client_ip (optional) : If add_client_ip = true is in the JSON, the client IP address is pushed into the event's event_data as the tag ip_address. This boolean field is placed at the same level as the event_data dictionary.
  • event_data (required) : This field with the data that is being written. It can be multi-item and multi-level.

Note: The accepted size limit is 64k (65536 characters) per event from opening brace to closing brace

Streams

Streams are a logical grouping of data events that helps the user categorize their data. There are two main kinds of streams: Raw and Processed. Below, there is more information on how to use streams and more about the different types.

Raw vs. Processed streams

Raw streams consist of all the data generated by the API Basic User. Whenever this user sends JSON data into Medium One’s platform, it is automatically placed in the Raw streams. This data is untouched and not modified in any way. There is only one Raw stream and a new one cannot be created.

Processed streams come from the data generated through Medium One’s workflows. There is already a default processed stream in which all workflow events are grouped in but the user can create another processed stream if needed. If this is the case, the user would need to set the workflow output to go to this processed stream in the Workflow Studio.

View, create, edit, and delete streams

To view the streams, click on the Data Streams page under Data Viewer. By default, every project has a “Raw Stream” and “Processed Stream”.

To be able to create, edit, or delete streams, the user must be a Web Administrator. 

On this page, only a new processed data stream can be created. However, both Raw and Processed streams may be edited. In the edit page, the Web Administrator can change the name of the stream as well as make a tag active or inactive. More information on tags can be found in the next section.

Similarly to creating streams, only processed streams may be deleted.

Note: If a Web Administrator deletes a processed stream, the workflows that send data to this stream is automatically deactivated.

Tags

As mentioned in the introduction, Tags are also known as “keys” and sent with the “ value”. Tags, in addition to Data Streams, help categorize the event data even further. Here are some examples of Tags:

  • age
  • height
  • battery_level
  • BPM

Note: Medium One accepts alphanumeric characters, underscores, and dashes for Tag names.  

Every time a new tag is sent to Medium One, it is auto-detected and will appear in its respective stream. The values that are sent with the Tags can vary in each event. (i.e. battery_level can be 100 in one event and 75 in the next).

Data Types for each new tag are also auto-detected and will be further explained in the Data Types section below.

How to activate Tags

By default, every new tag is set as an Inactive tag. To be able to visualize this data on Medium One, it must be set as Active. This can be done on the editing Data Streams page as shown on this image:

Note: If there is a mismatch between Tag and Data Type, the data may not be displayed correctly in the widgets.