2. Domains, users, edges, and measurements in intdash#

My Page v3.3.0 / Meas Hub v1.6.0 / Media Explorer v1.1.0 / Edge Finder v2.7.0 / Admin Console v1.3.0

This chapter describes the main concepts used in intdash.

../_images/concept-domain-user-edge.en.svg

Fig. 1 Domain, user, edge#

2.1. Domain (intdash domain)#

A single intdash environment, centered around an intdash server, is called a domain (or intdash domain).

Only users and edges (devices that send and receive data) with accounts issued in that domain can connect to the intdash server.

The domain has at least one administrator user with the admin role.

2.2. Users and edges#

There are "users" and "edges" as entities connected to intdash.

User

People who use intdash are called "users". Users mainly browse time series data using web applications and mobile applications.

Edge

Devices that use sensors to acquire data or are remotely controlled are called "edges". An edge sends and receives time series data to and from the intdash server.

A user who uses intdash need a "user account". Also, an edge requires an "edge account".

2.2.1. User account#

  • User accounts are created by the administrator of the intdash domain.

  • User accounts are assigned roles such as "admin" and "member".

  • Users with the admin role have the right to manage other users, such as creating and deleting user accounts. Normally, there are "admin" and "member" roles, but the available roles depend on the intdash domain.

  • Users can create and own edge accounts.

2.2.2. Edge account#

  • Edge accounts are created by users who have permission to create edges. In general, users with the "member" role can create edge accounts.

  • When a user creates an edge account, the user becomes the owner of that edge.

  • The edge account owner and intdash domain administrators can edit and delete edge accounts.

  • Administrator users can change the owner of the edge account. You can also leave the edge account unowned.

2.2.3. Different use of user and edge depending on the purpose#

Basically, it is the "edge" that generates time series data and sends it to the intdash server. Also, objects that operate by receiving time-series data from the intdash server (such as remotely controlled robots) are also "edges".

"Users" view and download time-series data and manage edges. If you are in the same domain, you can also view data on edges that you do not own.

Applications or SDKs to be used

Account used for authentication (sign in)

Credentials to use

Web application.

Data Visualizer, Meas Hub, Edge Finder, etc.

User

Username and password

Mobile application for browsing.

Stream Video, Stream Monitor, VM2M Viewer

User

Username and password

Mobile application for measurement.

intdash Motion

User

Username and password

intdash SDK for Python

User

API token, or username and password (username and password will be deprecated)

intdash Edge Agent, Terminal System

Edge

Client secret

Important

  • When using intdash Motion, you log in with your user account, but data acquisition and transmission must be performed as an edge. Which edge to acquire and send data as is configured in the settings screen of intdash Motion.

  • Authenticate with a user account when using the intdash SDK for Python. Real-time data must be sent and received as an edge, so when creating upstream or downstream in Python code, specify which edge to behave as. See the intdash SDK for Python documentation for more information.

Attention

Supplement for those who used the previous versions of intdash

The meaning of "edge" is slightly different between the old intdash (up to version 2.4 of the My Page application) and the new intdash. Please note the following points.

The new intdash distinguishes between users (people) and edges (devices)

  • In previous intdash, people and devices connected to intdash were indistinguishably called "edges".

  • In new intdash, people who connect to intdash are called "users" and devices that connect to intdash are called "edges" to distinguish between people and devices.

The new intdash does not allow you to sign in to web applications with your "edge" account

  • In the old version of intdash, a password was issued for edge accounts, and the edge name and password could be used to sign in to web applications.

  • With new intdash, edge accounts are only for devices, so edge accounts are not expected to use web applications. As a result, no password is issued to your edge account and you cannot use your edge name and password to sign in to web applications.

In new intdash, the edge account is set up by the owner user

  • In previous versions of intdash, you could configure your edge account by signing in to My Page using your edge account.

  • With the new intdash, edge accounts should be set up in My Page by the user who owns that edge.

    Also, a user with the admin role can change the settings for all edge accounts in the domain.

2.3. Measurement#

In intdash, a collection of time-series data points that share a certain base time is called a "measurement".

For example, the example in the figure below represents a measurement that started at 9:00:00 on September 1, 2020.

../_images/concept-measurement.en.svg

Fig. 2 Concept of measurement#

The start of measurement at 2020-09-01 09:00:00 is set as the base time. The speed is 15.0 km/h at 0.10 seconds from the base time, 17.5 km/h at 0.15 seconds, 19.5 km/h at 0.30 seconds, and so on. A collection of these series of data points with a single base time is a measurement.

Measurements always record information about the edge that sent the data (the edge where the measurement was performed). Therefore, applications such as Meas Hub can list the measurements sent from a specific edge.

Note

intdash manages time by breaking it down into a base time and the time elapsed from that base time. For more information, see iSCP 1.0 Essentials.