# HashSphere Console

### Overview

The HashSphere Console provides visibility into platform health and throughput. It is designed for DevOps and technical support teams.

You can view:

* Node and service status
* Transaction volume by type
* Transactions per second (TPS)
* Time to consensus

### Console setup

The HashSphere team sets up the Console. You configure your corporate identity provider (IdP) to grant access.

Your IdP must support OIDC. If it does not, coordinate an alternative during onboarding.

1. Create a new group within your IdP that will contain all the users who should have access to the Console. You could also reuse an existing group if you already have one that’s suitable.
2. Update the configuration of your IdP with the redirect URLs provided for your environment.

```
OIDC_REDIRECT_URL=https://iob.hashsphere.info/login/oidc/callback/
OIDC_LOGOUT_CALLBACK_URL=https://iob.hashsphere.info/login#
# This URL must also be added to the IdP configuration under "Allowed Logout URLs".
REDIRECT_POST_LOGIN=https://iob.hashsphere.info/dashboard/
```

{% hint style="info" %}
Replace `iob.hashsphere.info` with your Console domain. The HashSphere team will confirm the correct values during onboarding.
{% endhint %}

3. Share the following values with the HashSphere team:

```
OIDC_CLIENT_ID
```

```
OIDC_CLIENT_SECRET
```

```
OIDC_ISSUER_URL
```

```
OIDC_AUDIENCE
```

```
OIDC_SCOPE
```

### Adding users

To grant access, add users to the IdP group created for Console access.

Users also need network access to the HashSphere endpoints. Without that, they will not reach the Console login screen.

### Console data: dashboard

<figure><img src="https://2074645427-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1lwtTuSxq9S9wuqIw74y%2Fuploads%2FjntUDM5vGNosPNXVGQs2%2Funknown.png?alt=media&#x26;token=2ac3c2b2-1afd-458d-b4de-8c8c22d52eb4" alt="" width="563"><figcaption></figcaption></figure>

The Dashboard is the primary landing screen for the Console and contains overview information about the health and utilization of the environment.

#### Network overview

<figure><img src="https://2074645427-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1lwtTuSxq9S9wuqIw74y%2Fuploads%2FFKKLWk2YjctclwSoGIax%2Funknown.png?alt=media&#x26;token=805d61e1-25b6-413d-abb8-abce7fa98d73" alt="" width="375"><figcaption></figcaption></figure>

This screen includes:

* Total number of entities created. Entity limits depend on node sizing.
* A breakdown of commonly used entity types via **View Details**.

<figure><img src="https://2074645427-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1lwtTuSxq9S9wuqIw74y%2Fuploads%2F5gkJKDY47bNKJc0qTGEF%2Funknown.png?alt=media&#x26;token=75a9c443-e5c6-40a5-85fd-f7b5101845a3" alt="" width="375"><figcaption></figcaption></figure>

* Total user accounts created.
* Active consensus nodes shown as `active/total`.
* Mirror service health status.

#### Transactions

<figure><img src="https://2074645427-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1lwtTuSxq9S9wuqIw74y%2Fuploads%2FyZIwtsHYGW4IpA5hGswl%2Funknown.png?alt=media&#x26;token=e9f04050-4c6f-4e28-b8cb-00cc07cc3ec5" alt="" width="563"><figcaption></figcaption></figure>

This view shows transaction volumes across a selected time window. It includes totals and a breakdown by transaction type.

#### Transactions per second

<figure><img src="https://2074645427-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1lwtTuSxq9S9wuqIw74y%2Fuploads%2F20xmF8i927fceBeUIXOS%2Funknown.png?alt=media&#x26;token=2acd794c-9585-4a4b-84e8-db20ba3315e5" alt="" width="563"><figcaption></figcaption></figure>

This view shows transaction processing speed across a selected time window.

#### Time to consensus

<figure><img src="https://2074645427-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1lwtTuSxq9S9wuqIw74y%2Fuploads%2FYbEH2H8XuCOs8yWjiO5V%2Funknown.png?alt=media&#x26;token=19682cce-0c2a-4119-b0c9-6e96ab00e511" alt="" width="563"><figcaption></figcaption></figure>

This screen shows the amount of time in milliseconds between the time that a transaction is submitted to the network, and when it has been accepted by all the consensus nodes. The view can be customized across multiple time windows.

#### Mirror node requests

<figure><img src="https://2074645427-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1lwtTuSxq9S9wuqIw74y%2Fuploads%2F2Xa28Z8yzHltDAsudsRB%2Funknown.png?alt=media&#x26;token=d4c9a304-837b-4065-b968-46192c4fdae0" alt="" width="563"><figcaption></figcaption></figure>

This view shows request volume across Mirror Node services.

### Console data: nodes

<figure><img src="https://2074645427-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1lwtTuSxq9S9wuqIw74y%2Fuploads%2FAIOSafOJSrUqaBwWixCX%2Funknown.png?alt=media&#x26;token=59f774c2-0443-4acf-ab1a-c4ad4df5eec4" alt="" width="563"><figcaption></figcaption></figure>

The Nodes view shows details for each configured consensus and mirror node, including:

* Node Status (active, inactive)
* Node Type (Consensus, Mirror)
* Cloud Provider
* Cloud Region
