azure / batchexplorer

A client tool to help create, debug and monitor Azure Batch Applications

BatchExplorer

Batch Explorer is a tool to manage your Azure Batch accounts. The goal is to implement a great user experience that will help you debug, monitor and manage your pools, jobs and tasks. It will also include experimental features such as Batch Templates in the aim to improve your Batch experience. We are open to any feedback, ideas and contributions you might have.

Downloads

You can download the latest version at https://github.com/Azure/BatchExplorer/releases

To build Batch Explorer yourself see this wiki

Feedback

• Request a new feature on GitHub
• Vote for popular feature requests
• File a bug on GitHub

Developers

Dev docs

Data/Telemetry

Batch Explorer collects usage data and sends it to Microsoft to help improve our products and services. Read Microsoft's privacy statement to learn more.

Please go see How to disable crash reporting and telemetry to disable it

License

Copyright (c) Microsoft Corporation. All rights reserved.

Batch Explorer is licensed under MIT See license

Some icons are under Creative Commons Attribution-ShareAlike 3.0 Unported See license

batchexplorer's Issues

Clone UX for entities

Each creatable entity should be able to be cloned from an existing.
This should just open a new create form with the input filled with the source entity values.

• Clone pool
• Clone job
• Clone task

Node list loading icon doesn't disapear

When clicking on a pool, the node loading icon doesn't disapear sometimes

Azure Active Directory: make user choose batch account from their AAD account

• List available account to user(List subscription then account under)
• Account dropdown should list each favorite and a link to the subscription
• User select account as favorite and store url/key node-keytar

Should still be able to add account by url+key

Test accounts don't show up in ARM so we need to be able to still add those by Url and key

List and tables context menu

Context menu for items in quick list and tables

e.g.

Task -> Delete, Terminate, etc.

Azure Active Directory: user sign in and retrieve access token for azure

• User should sign in to active directory before being able to do anything.
• Retrieve access token to user on azure resource management

Work on feature/aad2

File tailing

Ability to tail a task file.

Breadcrumbs should use navigation

Breadcrumb should be relative to the current navigation.

• When clicking on one of the left nav it should reset.
• Should maybe only show the first item of the list and last few in case it get too long (Job a > ... > Node xyz > file.txt)

Pool autoscale formula

Pool autoscale formula builder
Simply the autoscale formula with a builder that take a few inputs such as

• Min nodes
• Max nodes
• Cpu usage
• Queue length

Task status preview missing tooltip

Missing tooltip for the task preview on the quicklist

File tail "follow log" should be sticky

Position top right of the log. If scroll make it to the top of the log move to fixed position so it stay on the screen at all time.

Task output toggle between stdout and stderror

Should have radio button(or equivalent) to switch between stdout(default) and stderr.

Do a head query to see if stderror is empty or not and show that in the radio button

Heatmap v1

Add a heatmap to the pool UI.

Work in feature/heatmap

Improved complex form experience

Create forms needs a form wizard(Stepper).

• Multi page forms
• Bottom sticky footer to be able to submit form at any time
• Picker to open a new form page
• Automated sections
• Write documentation

Write test resource file picker

Resource file picker added with #56 is missing spec

Add task resource files

Add task should support resource files

Create job and create task notification test is wrong

When I add jobs or tasks, the green pop-up message says “Pool added! PoolN created successfully” (i.e., instead of job/task added)

Tabs should use routing

Clicking on a tab should change the route. This will allow to go directly to a specify tab.

This needs @angular/material2 update(> beta.10)

Pool detect start task error

When many nodes are in start task fail state propose fixes:

• edit the start task
• reboot nodes
• reimage nodes

Nav/UX could be improved when account added (and no account selected)

Description
If you add a new account, then click it in the left pane, and then click Jobs or Pools on the left nav rather than in the main area, nothing shows in the main area, as it appears the account hasn't been 'selected'.

I would suggest two changes;

1. Clicking the newly added account in the left pane should activate it.
2. If there's no active account selected then the left nav should be disabled (it wasn't super obvious the issue was due to the account still not being activated/selected as the warning is small and on the other side of the screen).

Simple popup notifications

Should popup a notification then autdismiss after time

Clicking a job produces a null toString error and renders app unusable

Description

App stops responding after clicking on one of the jobs in my list. The following error is reported in the console:
core.umd.js:2840 TypeError: Cannot read property 'toString' of null
at new JobDecorator (job-decorator.ts:38)
at JobPropertiesComponent.refresh (job-properties.component.ts:34)
at JobPropertiesComponent.set job [as job] (job-properties.component.ts:14)
at Wrapper_JobPropertiesComponent.check_job (wrapper.ngfactory.js:20)
at DebugAppView.View_JobDetailsComponent1.detectChangesInternal (component.ngfactory.js:703)
at DebugAppView.AppView.detectChanges (core.umd.js:9326)
at DebugAppView.detectChanges (core.umd.js:9419)
at ViewContainer.detectChangesInNestedViews (core.umd.js:9491)
at DebugAppView.View_JobDetailsComponent0.detectChangesInternal (component.ngfactory.js:67)
at DebugAppView.AppView.detectChanges (core.umd.js:9326)

Task list is missing multi delete

Job and pool have multi select delete button. Task is missing it.

Make a open component in a new window

It would be nice to be able to open some UI in a new window for stuff like log tailing or heatmap

Tests run twice

Seems like each test is run twice.

Heatmap should have a selected item indication

Currently clickin on a node show the preview but then we don't know which node in the heatmap it is.

Update to webpack 2 to fix the error in the console

Error keep showing in the console. This is fix in webpack 2.0

Notification persistance

Some notification should be persisted.
After auto dismiss the notification should move to a tray where the user can go back and see

Change dev server port from 8080

8080 is too common change to something less likely to conflict.

List multi select should change color when losing focus

Currently it looks a bit weird if you select multiple entities then click on the details for example as the selection remains the same. Should probably change to a light gray color

Production build

Work on the production build: feature/prod-webpack

• Run angular in production mode
• Combine all styles into files(extract-text-plugin for webpack)
• Minifiy and gzip all javascript and styles
• Have angular2 handle errors
• Make bunyan log to file
• Don't show the developer tools

List task & view files

I'm submitting a ... (check one with "x")

[ ] bug report => search github for a similar issue or PR before submitting
[x] feature request

User should be able to list and view task files

Navigate to a task - click on a "Files" tab and view a list of files associated to the task. Click on a single file should show the file in the UI as well as a download button.

Pool quota reach propose fix

Open url to the portal request support for quota increase

App needs better handling of unhandled errors.

We have known for some time that unhandled errors crash the application rather than just log and carry on. We really need to spend some time thinking about how we can stop the app from crashing when there is an error that is not expected.

AAD: make refresh token auto refresh when closing expiry date

Should refresh the access token automatically when closing expiration date.
Would reduce request time

Account should use id for navigation

Account currently use the name for the navigation which means 2 account with the same name can't be used in the app.

Create pool form troubleshoot details should maybe not replace the main info but show under

Currently when clicking on the debug button of an error we replace the main content with the request id

Form errors directive/component

Currently errors in form templates looks like this

<div *ngIf="createJobForm.hasError('validateRange', ['priority'])" class="required-alert">Priority values can range from -1000 to 1000</div>

Should make a directive or component so it looks more like this

<div formControlError="priority" errorName="validateRange">Priority values can range from -1000 to 1000</div>

File content loading icon

It is quite slow to load the content of a file event for empty files.
Add a loading icon to tell the user something is actually happening

Property group collapse option

Property group which are not important to show in the first place should be collapsed by default

Support also some preview for when the group is collapse

bex-error should not show error until the input was touched

Currently when you open a form all the required errors show up.

Pool rescale form should use the forms control to handle error

Probably need to refactor the create-form and action-form controls which are very similar to both support dialog and sidebarref

Write spec for property list

Property list is missing specs

ListAndShowLayout quicksearch customize startwith field

ListAndShowLayout hard code the quicksearch field to be id. Add an input which value default to Id

Heatmap show running task information

Heatmap should be able to show more data than just running.

Idea: show square inside a node tile for each task running or some kinda of bar chart.

This might require some zooming functionality for large pools.

Error handling for general actions

Same as a create-form actions should have some sort of error handling.
Work on a action componen bex-action-form that work in a similar maner as the bex-create-form

Export entities to template to allow cloning after deleted

From #5

If you're going to do something like this, it would be quite nice to be able to persist the clone source as a file, so I don't need to keep a pool around 'to clone from'. These could be in the format of Azure Batch templates (aka NCJ templates) so a savvy user could easily edit and parameterise them... and longer term we would have a nice two-way story going.

Forms error show request id

Currently when the service return an error in a create-form we show the code, message and details.
But the request id is parsed out.

Add a troubleshoot button on the error banner that show the request id and request time.

Rerun task

• Rerun task with same setting (Reactivate api)
• Rerun task width different settings(This needs to delete it and recreate it to keep the same id)

Tslint rule to disable focus

Keep commit fdescribe and fit. Need a rule that prevent that