Skip to content

Commit eb57c46

Browse files
authored
Improving session management documentation
1 parent dcd77c7 commit eb57c46

File tree

1 file changed

+36
-2
lines changed

1 file changed

+36
-2
lines changed

articles/machine-learning/how-to-access-terminal.md

Lines changed: 36 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -141,7 +141,41 @@ Upon refresh, the kernel list in your notebooks view should reflect the changes
141141

142142
## Manage terminal sessions
143143

144-
Select **View active sessions** in the terminal toolbar to see a list of all active terminal sessions. When there are no active sessions, this tab will be disabled.
144+
Terminal sessions can stay active if terminal tabs are not properly closed. Too many active terminal sessions can impact the performance of your compute instance.
145+
146+
Select **Manage active sessions** in the terminal toolbar to see a list of all active terminal sessions and shut down the sessions you no longer need.
147+
148+
Learn more about terminal and notebook sessions [on the next docs page]()
145149

146150
> [!WARNING]
147-
> Make sure you close any unused sessions to preserve your compute instance's resources. Idle terminals may impact performance of compute instances.
151+
> Make sure you close any sessions you no longer need to preserve your compute instance's resources and optimize your performance.
152+
153+
154+
155+
156+
## Managing notebook and terminal sessions
157+
158+
Notebook and terminal sessions run on the compute and represent and preserve the current state of your notebook or terminal.
159+
160+
When you re-open a notebook, or reconnect to a terminal session, this allows you to reconnect to the previous session state (including command history, execution history, and defined variables). However, too many active sessions may slow down the performance of your compute. This may make terminal or cell typing feel laggy, or cause terminal commands to feel slow or notebook execution to take longer than expected.
161+
162+
There is a session management panel in the Azure Machine Learning studio that can help you manage your active sessions and optimize the performance of your compute instance. You can navigate to this session management panel from the compute toolbar of either a terminal tab or a notebook tab.
163+
164+
> [!NOTE]
165+
> For optimal performance, we recommend you don’t keep more than ten active sessions - and the fewer the better.
166+
167+
<insert screenshot of session management panel>
168+
169+
### Terminal sessions
170+
Terminal sessions are terminated when you close a terminal tab in the Azure Machine Learning studio. If you navigate away from the Azure Machine Learning studio without closing it, the session may remain open and should be shut down if no longer needed.
171+
172+
Select **Manage active sessions** in the terminal toolbar to see a list of all active terminal sessions. You can see below that the icon shows the count of active terminal sessions.
173+
174+
<insert screenshot of terminal compute toolbar with "Manage active sessions" hovered>
175+
176+
### Notebook sessions
177+
In contrast, notebook sessions are kept active unless they are shut down explicitly. This enables you to reconnect to your previous notebook session state, and means that when you close a notebook tab, the session is kept active. If you'd like to reconnect to a notebook and have access to previously-defined variables and execution state, you will benefit from the active session. However, keeping too many notebook sessions open can slow down the performance of your compute.
178+
179+
Select **Manage active sessions** in the notebook toolbar to see a list of all active notebook sessions. You can see below that the icon shows the count of active notebook sessions.
180+
181+
<insert screenshot of terminal compute toolbar with "Manage active sessions" hovered>

0 commit comments

Comments
 (0)