B. Quick Reference
Toolbar buttons
Every notebook (card or JupyterLab) gets the same toolbar buttons. Left to right:
| Button | What it does | Article |
|---|---|---|
| Runtime toolbar (template + instance dropdowns + status + action) | Attach the notebook to a runtime template's instance — bigger driver, more executors, GPU access, runtime-specific Spark config. | Runtime Attachment in Notebook Workspaces |
| Init script editor (terminal-prompt icon) | Open the per-notebook init script editor — bash that runs before Spark session creation, after the global and runtime layers. | Init Scripts & Dependencies |
| Kernel logs viewer | Stream kernel and Spark driver logs in a modal — Bootstrap and Spark tabs, severity coloring, search, download. | Kernel Logs Viewer |
| Spark UI (Spark icon) | Open the live Spark Applications UI in a new tab. Disabled until the Spark session is ready. | Spark UI Access |
Log file paths
All under /logs/ on the kernel pod. The kernel logs viewer reads from these:
- global_init_script.log — global init script output.
- global_init_configs.log — global dependency installs and JAR downloads.
- notebook_init_script.log — per-notebook init script output.
- runtime_init_script.log — runtime template init script output.
- runtime_init_configs.log — runtime dependency installs and JAR downloads.
- syntasa_kernel.log — aggregated kernel output (Bootstrap tab in the viewer).
- spark_driver.log — Spark driver / JVM logs (Spark tab in the viewer).
synutils cheat sheet
| Module | Most-used calls |
|---|---|
| credentials | get(name, key) · getAll(name) · list() |
| lib | installPyPI(packages) · installCondaPackage(packages) · installJars(jars) [Scala] |
| notifications | send(recipients, subject, message, attachments=…) |
| connections | get(name) · getParam(name, param) · getAllParams(name) |
| infrastructure | providerType · region · bucket · storagePath · getStorage() · getMetastore() |
| eventstores | get(name, env=…) · getPath(name) · getDatabase(name) · configure(defaultName=…) → path / database / name |
| datasets | get(datasetName) · create(datasetName) · list(eventStoreName) |
| spark | createDataFrame(datasetName) · writeDatasetToEventStore(df, datasetName) · writeToEventStore(df, datasetName, …) |
| fs | ls · listRecursive · exists · upload · download · uploadFolder · downloadFolder · copy · move · delete · content · head · stream |
| files | get(name) · getPath(name) · createDataFrame(name, fileName) |
Common environment variables
These show up in init scripts and logs; useful to know what they mean:
- KERNEL_SYN_USERNAME — the Syntasa username the kernel runs as.
- KERNEL_WORKSPACE — the workspace the kernel belongs to.
- KERNEL_TEMPLATE_ID — present when a runtime template is attached; absent on the default kernel.
- KERNEL_NOTEBOOK_PREFIX — the path within the workspace where the notebook lives.
- $SPARK_HOME/jars/ — directory whose contents are automatically on the Spark classpath. Drop JARs here from an init script.