Skip to content
English - United States
Contact us
  • There are no suggestions because the search field is empty.

Creating Analysis

This article explains how to create a new Analysis in TagoIO, including the fields in the Add Analysis dialog and the options for runtime and execution environment.

Creating your own analysis is easy. First, click on Analysis in the sidebar, then click the + Add Analysis button in the upper‑right of the Analysis main screen. Enter a name and configure the options described below to create your analysis.

Name

This is the identifier for your analysis. You can use whitespace, numbers, and any other characters in this field. Choose a descriptive name that explains the purpose of the code.

Runtime Version

Select the runtime environment for your analysis. An example shown in the dialog is:
  • Deno (deno‑2025‑08‑01)

Currently supported runtimes include Deno, Python, and Node.js if you run your script on TagoIO.

Run this script from

Choose where the analysis will run:
  • TagoIO — Edit and run the script directly on TagoIO.
- External — Run the script on your own computer or server.

If you select the external option, we provide the following SDKs so you can run the analysis directly from your machine:

- Javascript SDK for Deno and NodeJS

:::warning

When changing between External mode and TagoIO mode, the Analysis Token will be reset and a new token will be generated.

:::

Code example

You can optionally start your analysis from a code example template. The Add Analysis dialog includes a dropdown to choose a code example. If you don't want a template, select No, thanks.

:::tip

It is highly recommended for beginners to use a real‑world example, as it provides insight into the functions and scopes of the script. You can only select one of these code examples if you are running your script on TagoIO.

:::

Other fields

The Add Analysis dialog also shows:
  • A “Learn more” link (for additional guidance).
- Buttons to “Cancel” or “Create my Analysis” once you have configured the fields.

After creating the analysis you can open the Script Editor to add and manage the analysis code, adjust environment variables, and configure distribution or external execution as needed.

Time interval

You can trigger your analysis script manually, but you can also define a time interval to automatically trigger it. In this field you will find a couple of predefined time options, and you can set your own custom time interval by selecting the Custom option.

Analysis Token

This field is only used if you are running your analysis as external. If you want more information on how the token works, check out the article Running Analysis as External using Node.JS.