1. Getting Started
  2. Intuned 101

Concepts

  • Workspace - is automatically created for those who sign up to Intuned, once created the workspace owner can invite others as collaborators in the same workspace
  • Connectors - are the conduit to centralize and sync your team’s data into a shared central workspace. Note connector configuration is global to the workspace, thus it is shared amongst collaborators
  • Metrics - are simply custom query results which are automatically tracked over time in a table for you to review as you make improvements.
  • Notifications - is the custom alerting mechanism that allows you to get notified periodically or when some in the query results change.
  • Worksheets - is the container to save queries and share them with others.
  • Views - allows you to augment query results into a saved table you can call upon within your queries

Explore

To explore and learn more about your team’s data connected in Intuned, you can navigate to Explore.

To help you learn more about your, Explore is broken down into 3 main components:

  • Resource Manager allows you to view and manage worksheets and table schemas for your connected data sources, metrics, and custom views.
  • Query Editor is where you go about actually writing up the queries, Intuned supports SQL and Kusto as the querying language
  • Query Results is where you will see the results of the query either in table or chart form depending on the query
Explore

Resource manager

Resource manager provides you with the following capabilities:

  • view, create and delete shared and private worksheets to save queries
  • view the table schema of the data sources from the connected tools and metrics you’ve created.
  • view, create, and delete views to augment query results into a saved result you can call upon similar to a table

Worksheets

  • Workspace worksheets are visible to all who are invited to the workspace
    • Known limitation is collaborating on the same worksheet is not possible right now
  • Private worksheets are only visible to you

Query editor

Both Kusto Query Language and SQL are supported. Kusto has wider support while SQL has some limitations. To switch between the two simpily toggle the control on the editor and then run the respective query.

To run a query, type in a query and select the query you wish to run in the editor experience and then hit run or “Shift + Enter”. You can find samples here: Samples

Connectors

Jira Connector

Analyze your team’s Jira data alongside your engineering tools like GitHub and track and measure your team’s performance, project lifecycles, issues and more in Intuned.

Linear Connector

Analyze your team’s Linear data alongside your engineering tools like GitHub and track and measure your team’s performance, project lifecycles, issues and more in Intuned.

Metrics

Create metrics

Metrics

To create a metric:

  • Navigate to Metrics and select “Create metric”
  • Then provide the required prarameters
    • Metric Name: This name must be unique and cannot contain any spaces or special characters as it will be used as the table name
    • Cron expression to schedule: This cron expression will configure when and how frequently the query will be run to capture and store the results in to the metric table along side the timestamp of when the query was run.
    • Query: This query is filtered to calulate a specific metric you are looking for, and it will be captured in a regular cadence as defined by the cron expression.
  • Then come back after some time and you will find a table with the query results associated with a timestamp.

Manage metrics

To manaage a metric:

  • Navigate to Metrics, find the Metric you wish to manage
  • To delete a metric, use the trash bin icon and select “Delete Metrics” on the confirmation
  • To update a Metric, use the pencil icon and select “Edit Metrics”
  • To preview a metric, use the magnifine glass icon to “Preview Metrics”

Notifications

Notification is made up of 2 main components

  • The trigger is the condition that will result in an action. Intuned’s triggers run every 10 minutes to evaluate if trigger condition has been met.
  • The action is the email or slack notification that is sent once a trigger activated

Periodic Trigger

If there is any query result you wish to check up on a regular bases, then you can use Periodic Trigger for these types of results you have to share frequently

Query change Trigger

If there is a query result you wish to get notified when things change, then you can use a Query Based Trigger.

Settings

Workspace settings allows you to govern access to users in your shared workspace.

  • Admin - A role that grants full administrative control within Intuned, and exclusively has authority over users, role assignments, and connectors management.
  • Editor - A role that grants the ability to create, updated, and delete all Intuned components except for users, role assignments, and connectors
  • Viewer - A role that grants the ability to view dashboards