Skip to content

Commit b3f0354

Browse files
docs: merge Monitoring and Mission Control (#628)
* docs: merge Monitoring and Mission Control Signed-off-by: David Dal Busco <[email protected]> * 📄 Update LLMs.txt snapshot for PR review --------- Signed-off-by: David Dal Busco <[email protected]> Co-authored-by: github-actions <41898282+github-actions[bot]@users.noreply.github.com>
1 parent 7391844 commit b3f0354

File tree

7 files changed

+55
-65
lines changed

7 files changed

+55
-65
lines changed

.llms-snapshots/llms-full.txt

Lines changed: 27 additions & 32 deletions
Original file line numberDiff line numberDiff line change
@@ -8084,7 +8084,7 @@ juno hosting deploy
80848084

80858085
# Monitoring
80868086

8087-
Keeping your modules running smoothly is essential for any application. The monitoring feature ensures your [Mission Control](/docs/terminology.md#mission-control) (your wallet) and modules — Satellites and Orbiter (Analytics) — stay operational by automatically refilling cycles when they run low. This helps prevent unexpected downtime, allowing you to focus on building and growing your product without worrying about cycle balances.
8087+
Keeping your modules running smoothly is essential for any application. The monitoring feature ensures your modules — Satellites and Orbiter (Analytics) — stay operational by automatically refilling cycles when they run low. This helps prevent unexpected downtime, allowing you to focus on building and growing your product without worrying about cycle balances.
80888088

80898089
![A screenshot of the monitoring overview within Juno Console](/assets/images/monitoring-dashboard-caf86757b1501c3fe41cbae3cffa3ff3.webp)
80908090

@@ -8093,23 +8093,23 @@ Keeping your modules running smoothly is essential for any application. The moni
80938093
## Features
80948094

80958095
* **Cycle refilling**: Monitored modules are automatically topped up when their balance falls below what's needed to stay active.
8096-
* **Self-Monitoring**: Your Mission Control ensures that both your wallet and modules maintain sufficient cycles, with full control remaining in your hands at all times.
8096+
* **Self-Monitoring**: The monitoring monitors itself to maintain sufficient cycles, with full control remaining in your hands at all times.
80978097
* **Automatic ICP Conversion**: Can mint new cycles from the ICP in your wallet, ensuring your modules stay adequately funded.
80988098
* **Hourly Checks**: The system evaluates balances once an hour.
80998099

81008100
---
81018101

81028102
## Why Enable Monitoring?
81038103

8104-
When a smart contract runs out of [cycles](/docs/terminology.md#cycles) on the [Internet Computer](https://internetcomputer.org), it stops functioning, which can disrupt your application or service. Enabling monitoring provides peace of mind by automating the management of cycles, ensuring your modules are always ready to perform. It also saves a little time by eliminating the need for manual top-ups.
8104+
When a container runs out of [cycles](/docs/terminology.md#cycles) on the [Internet Computer](https://internetcomputer.org), it stops functioning, which can disrupt your application or service. Enabling monitoring provides peace of mind by automating the management of cycles, ensuring your modules are always ready to perform. It also saves a little time by eliminating the need for manual top-ups.
81058105

8106-
It's important to note that if your wallet or a module run out of cycles, they will enter a grace period. During this time, the module stops working but can still be restored. If no action is taken, the module eventually gets deleted, resulting in the permanent loss of its data and functionality.
8106+
It's important to note that if your modules run out of cycles, they will enter a grace period. During this time, the module stops working but can still be restored. If no action is taken, the module eventually gets deleted, resulting in the permanent loss of its data and functionality.
81078107

81088108
---
81098109

81108110
## How does it work?
81118111

8112-
Monitoring runs hourly within your Mission Control, which acts as the central hub for managing all monitored modules. The process follows these steps:
8112+
Monitoring runs hourly within a dedicated service called Mission Control, which acts as the central hub for managing all monitored modules. The process follows these steps:
81138113

81148114
---
81158115

@@ -8198,9 +8198,14 @@ In the case of failed attempts (e.g., when Mission Control or a module could not
81988198

81998199
## Configuration
82008200

8201-
To enable monitoring, go to the [Monitoring Section](https://console.juno.build/monitoring) in the Juno Console. Start the wizard by clicking **Enable Auto-Refill** and follow the prompts to select the modules you want to monitor, choose a pre-defined strategy or create a custom one, and enable the feature.
8201+
To enable monitoring, go to the [Monitoring Section](https://console.juno.build/monitoring) in the Juno Console. Start the wizard by clicking **Get started** and follow the prompts to:
82028202

8203-
The wizard simplifies the setup process, making it easy to configure monitoring according to your needs.
8203+
* Create the Mission Control service
8204+
* Select the modules you want to monitor
8205+
* Choose a pre-defined strategy or create a custom one
8206+
* Enable the feature
8207+
8208+
The wizard guides you through the setup process, making it easy to configure monitoring according to your needs.
82048209

82058210
# Snapshots
82068211

@@ -8248,14 +8253,12 @@ This should be used carefully though, as snapshots also include elements such as
82488253

82498254
# Access Keys
82508255

8251-
Access keys play a crucial role in granting permissions to Mission Controls, Satellites or Analytics within Juno.
8256+
Access keys play a crucial role in granting permissions to Mission Controls, Satellites or Orbiters within Juno.
82528257

8253-
When you sign in to Juno's [Console](/docs/terminology.md#console) using [Internet Identity](https://internetcomputer.org/internet-identity), you — and no one else (including not Juno) — become the owner of your [mission control](/docs/terminology.md#mission-control). This information is then sent back to your browser, where you can manage your modules.
8258+
When you sign in to Juno's [Console](/docs/terminology.md#console) (for example, with Internet Identity) and create modules, you — and no one else, not even Juno — become their owner.
82548259

82558260
![Juno&#39;s console flow](/assets/images/console-d0903e4989f7c4db5f4e85567211d266.png)
82568261

8257-
When you create a [satellite](/docs/terminology.md#satellite), you and your Mission Control become its owners. Per extension, you — and no one else (including not Juno) — own your satellite.
8258-
82598262
**Note:**
82608263

82618264
* What was previously referred to as _controllers_ in earlier versions of the documentation is now called _administrative access keys_. The concept remains the same — only the terminology has been updated for clarity and consistency.
@@ -8273,7 +8276,7 @@ Each access key is assigned a **role** that defines what it can do:
82738276
| **Write** | Editor | ✅ | ✅ | ✅ | ❌ |
82748277
| **Submit** | Submitter | ✅ | ❌ | ❌ | ❌ |
82758278

8276-
An **administrator** can perform tasks such as configuring or deploying an app, topping up a Mission Control or satellite, creating a new collection in the [datastore](/docs/build/datastore.md) or [storage](/docs/build/storage.md), or configuring a custom domain in the [hosting](/docs/build/hosting.md).
8279+
An **administrator** can perform tasks such as configuring or deploying an app, topping up a module, creating a new collection in the [datastore](/docs/build/datastore.md) or [storage](/docs/build/storage.md), or configuring a custom domain in the [hosting](/docs/build/hosting.md).
82778280

82788281
An **editor** can publish new serverless function versions to a Satellite’s CDN, deploy your frontend application, and read data from a collection. However, it cannot directly upgrade a Satellite or start/stop a module.
82798282

@@ -8339,7 +8342,7 @@ When you run the command, the CLI checks if an access key is already present on
83398342

83408343
### Generate a new access key
83418344

8342-
To **generate a new access key** and attach it to your desired Mission Controls and Satellites, you can run:
8345+
To **generate a new access key** and attach it to your desired module, you can run:
83438346

83448347
```
83458348
juno login
@@ -8390,10 +8393,6 @@ Juno provides supporting services to manage your projects, while keeping everyth
83908393

83918394
The Console is a platform for managing your projects. It runs as its own container, combining a user interface with orchestration logic.
83928395

8393-
It only holds one piece of data: a keypair linking each developer's anonymous ID to their Mission Control ID.
8394-
8395-
When you sign in, the Console returns your Mission Control ID. From there, all project management happens under your control. The Console does not have access to your apps, your data, or your infrastructure.
8396-
83978396
It provides services such as:
83988397

83998398
* Creating, upgrading, and deleting Satellites.
@@ -8428,13 +8427,7 @@ While it functions as a CDN, technically it's not a traditional content delivery
84288427

84298428
## Developer-Owned Spaces
84308429

8431-
### Mission Control
8432-
8433-
Mission Control is your personal management container. It tracks your Satellites and Orbiters, and it acts as your wallet.
8434-
8435-
You use it for example to spin up new containers or provide [cycles](/docs/terminology.md#cycles) to keep your modules running. It serves as your central hub for managing projects and resources.
8436-
8437-
Mission Control belongs to you. No one else can access it — not Juno, not the Console, not any other service.
8430+
Juno's architecture is built on a microservices approach, where each component runs independently as its own WASM container, giving you modular control over your infrastructure.
84388431

84398432
### Satellites
84408433

@@ -8450,6 +8443,12 @@ Satellites are your applications. Each one is a self-contained unit that bundles
84508443

84518444
Orbiters provide analytics — a decentralized alternative to services like Google Analytics. Orbiters collect traffic, page views, and device information, under your ownership and without exposing user data to third parties.
84528445

8446+
### Mission Control
8447+
8448+
Mission Control is an optional monitoring service that automatically tracks and maintains your Satellites and Orbiters.
8449+
8450+
When enabled, it monitors [cycles](/docs/terminology.md#cycles) balances across your modules and automatically tops them up when needed, ensuring your applications stay running without manual intervention.
8451+
84538452
---
84548453

84558454
## CI/CD and Deployment
@@ -11835,7 +11834,7 @@ For reproducibility, developers can run the official Docker build for Juno and i
1183511834

1183611835
### What happens if Juno disappears?
1183711836

11838-
In the unlikely event of Juno's disappearance, you, as the sole controller of your [mission control](/docs/terminology.md#mission-control) and [satellites](/docs/terminology.md#satellite), would retain full control over your creations. They would continue to function independently without any reliance on Juno.
11837+
In the unlikely event of Juno's disappearance, you retain full control over your creations. They would continue to function independently without any reliance on Juno.
1183911838

1184011839
### Can I just deploy my website on the Internet Computer?
1184111840

@@ -11849,7 +11848,7 @@ No, Juno is an independent project. In 2024, we received a [Developer Grant](htt
1184911848

1185011849
No, Juno does not exert any control over developers' work. Juno is designed to provide developers with true control and autonomy over their projects.
1185111850

11852-
Developers have full ownership and control over their [mission control](/docs/terminology.md#mission-control), [satellites](/docs/terminology.md#satellite), and the applications they build on the platform.
11851+
Developers have full ownership and control over their modules, and the applications they build on the platform.
1185311852

1185411853
Juno's philosophy aligns with the principles of Web3, empowering developers with transparency, decentralization, and the freedom to create and innovate without external interference.
1185511854

@@ -12026,13 +12025,9 @@ It is free and passwordless. It integrates WebAuthn for maximum compatibility an
1202612025

1202712026
## Mission control
1202812027

12029-
Mission control is the command center for your project. It is under your exclusive control, allowing it, for example, to hold ICP and perform various operations such as topping up your modules.
12030-
12031-
Think of it like the command center for a space mission. Just as NASA's Mission Control coordinates spacecraft and Satellites, your Mission Control manages all your [satellites](/docs/terminology.md#satellite) or ([orbiters](#orbiter)).
12032-
12033-
Because it can hold ICP and is only controlled by you, your Mission Control also functions as your ([wallet](#wallet)).
12028+
Mission Control is an optional monitoring service. When enabled, it automatically monitors and tops up your Satellites and Orbiters to keep them running smoothly.
1203412029

12035-
For a schematic representation, refer to the [Architecture](/docs/miscellaneous/architecture.md) documentation page.
12030+
Think of it like the command center for a space mission. Just as NASA's Mission Control monitors spacecraft and Satellites, your Mission Control watches over all your modules and ensures they have the resources they need.
1203612031

1203712032
## Modules
1203812033

docs/build/analytics/index.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -81,7 +81,7 @@ You have the capability to delete all collected data within your Analytics at an
8181

8282
## How does it work?
8383

84-
To gather analytics for your dapps, you need to create an [orbiter]. Creating an Orbiter requires ICP, and its price is defined in the [transaction costs](../../pricing#transaction-costs).
84+
To gather analytics for your dapps, you need to create a module called [orbiter]. Creating an Orbiter requires ICP, and its price is defined in the [transaction costs](../../pricing#transaction-costs).
8585

8686
Each Orbiter is used to collect analytics for one or multiple [satellites].
8787

docs/faq.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -37,7 +37,7 @@ For reproducibility, developers can run the official Docker build for Juno and i
3737

3838
### What happens if Juno disappears?
3939

40-
In the unlikely event of Juno's disappearance, you, as the sole controller of your [mission control] and [satellites], would retain full control over your creations. They would continue to function independently without any reliance on Juno.
40+
In the unlikely event of Juno's disappearance, you retain full control over your creations. They would continue to function independently without any reliance on Juno.
4141

4242
### Can I just deploy my website on the Internet Computer?
4343

@@ -51,7 +51,7 @@ No, Juno is an independent project. In 2024, we received a [Developer Grant](htt
5151

5252
No, Juno does not exert any control over developers' work. Juno is designed to provide developers with true control and autonomy over their projects.
5353

54-
Developers have full ownership and control over their [mission control], [satellites], and the applications they build on the platform.
54+
Developers have full ownership and control over their modules, and the applications they build on the platform.
5555

5656
Juno's philosophy aligns with the principles of Web3, empowering developers with transparency, decentralization, and the freedom to create and innovate without external interference.
5757

docs/management/monitoring.md

Lines changed: 12 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -14,7 +14,7 @@ keywords:
1414

1515
# Monitoring
1616

17-
Keeping your modules running smoothly is essential for any application. The monitoring feature ensures your [Mission Control] (your wallet) and modules — Satellites and Orbiter (Analytics) — stay operational by automatically refilling cycles when they run low. This helps prevent unexpected downtime, allowing you to focus on building and growing your product without worrying about cycle balances.
17+
Keeping your modules running smoothly is essential for any application. The monitoring feature ensures your modules — Satellites and Orbiter (Analytics) — stay operational by automatically refilling cycles when they run low. This helps prevent unexpected downtime, allowing you to focus on building and growing your product without worrying about cycle balances.
1818

1919
![A screenshot of the monitoring overview within Juno Console](../img/monitoring/monitoring-dashboard.webp)
2020

@@ -23,23 +23,23 @@ Keeping your modules running smoothly is essential for any application. The moni
2323
## Features
2424

2525
- **Cycle refilling**: Monitored modules are automatically topped up when their balance falls below what's needed to stay active.
26-
- **Self-Monitoring**: Your Mission Control ensures that both your wallet and modules maintain sufficient cycles, with full control remaining in your hands at all times.
26+
- **Self-Monitoring**: The monitoring monitors itself to maintain sufficient cycles, with full control remaining in your hands at all times.
2727
- **Automatic ICP Conversion**: Can mint new cycles from the ICP in your wallet, ensuring your modules stay adequately funded.
2828
- **Hourly Checks**: The system evaluates balances once an hour.
2929

3030
---
3131

3232
## Why Enable Monitoring?
3333

34-
When a smart contract runs out of [cycles] on the [Internet Computer](https://internetcomputer.org), it stops functioning, which can disrupt your application or service. Enabling monitoring provides peace of mind by automating the management of cycles, ensuring your modules are always ready to perform. It also saves a little time by eliminating the need for manual top-ups.
34+
When a container runs out of [cycles] on the [Internet Computer](https://internetcomputer.org), it stops functioning, which can disrupt your application or service. Enabling monitoring provides peace of mind by automating the management of cycles, ensuring your modules are always ready to perform. It also saves a little time by eliminating the need for manual top-ups.
3535

36-
It's important to note that if your wallet or a module run out of cycles, they will enter a grace period. During this time, the module stops working but can still be restored. If no action is taken, the module eventually gets deleted, resulting in the permanent loss of its data and functionality.
36+
It's important to note that if your modules run out of cycles, they will enter a grace period. During this time, the module stops working but can still be restored. If no action is taken, the module eventually gets deleted, resulting in the permanent loss of its data and functionality.
3737

3838
---
3939

4040
## How does it work?
4141

42-
Monitoring runs hourly within your Mission Control, which acts as the central hub for managing all monitored modules. The process follows these steps:
42+
Monitoring runs hourly within a dedicated service called Mission Control, which acts as the central hub for managing all monitored modules. The process follows these steps:
4343

4444
---
4545

@@ -130,9 +130,14 @@ In the case of failed attempts (e.g., when Mission Control or a module could not
130130

131131
## Configuration
132132

133-
To enable monitoring, go to the [Monitoring Section](https://console.juno.build/monitoring) in the Juno Console. Start the wizard by clicking **Enable Auto-Refill** and follow the prompts to select the modules you want to monitor, choose a pre-defined strategy or create a custom one, and enable the feature.
133+
To enable monitoring, go to the [Monitoring Section](https://console.juno.build/monitoring) in the Juno Console. Start the wizard by clicking **Get started** and follow the prompts to:
134134

135-
The wizard simplifies the setup process, making it easy to configure monitoring according to your needs.
135+
- Create the Mission Control service
136+
- Select the modules you want to monitor
137+
- Choose a pre-defined strategy or create a custom one
138+
- Enable the feature
139+
140+
The wizard guides you through the setup process, making it easy to configure monitoring according to your needs.
136141

137142
[Analytics]: ../build/analytics/index.md
138143
[Satellites]: ../terminology.mdx#satellite

0 commit comments

Comments
 (0)