Job History
From GoGrid
Contents |
Overview
The Jobs tab in the GoGrid User Interface allows customers to track any actions that are taken on an object in their GoGrid cloud. API methods for jobs are also accessible through the GoGrid API.
Common actions that are logged in the Jobs interface are:
- Create virtual server
- Delete virtual server
- Start virtual server
- Restart Virtual Server
- Create load balancer
- Delete load balancer
- Update load balancer
- Provision cloud storage
- Update storage DNS
- Create dedicated server
- Delete dedicated server
- Restart dedicated server
Each action that is taken is logged with a UTC timestamp (the exact number of seconds since the Unix Epoch), the details of the action, the action status, and the user that requested the action.
Reading the Jobs Tab
The Jobs tab is available from the main Grid menu through your GoGrid Customer Portal. Each action taken on the grid is logged in date order descending. The most recent actions will appear at the top of the list. Each action or "job" is listed in a nested form with two attributed per job:
Job Details
The information entered during the job request:
- imageName: the name of the server image that was enacted upon (if applicable)
- serverName: the friendly name of the server image object (if applicable)
- description: the friendly description of the object that was enacted upon (if applicable)
- name: the friendly name of the load balancer that was enacted upon (if applicable)
Job State
The state of each phase of the request as it is executed:
- Created: the time and date the job request was made
- Queued: the time and date the job was received
- Processing: the time and date the job began processing
- Succeeded:the time and date the job was completed
- Fatal: the time and date the job became fatal (if applicable); this means the job failed and could not be executed to completion
- Canceled: the time and date the job was canceled by the system (if applicable)
- Failed: the time and date the job failed (if applicable); this may occur multiple times as a job can fail and then be queued again before succeeding or becoming fatal
Searching for Jobs
Quick Search
The Quick Search is available in the left-hand column of the Jobs tab. You can query your job history by object name only. Searches only accept the friendly name assigned to the object in question. To see the results for the server "My First Web/App Server", enter "My First Web/App Server" in the Quick Search. This tool does not support searches by IP address, hostname, date/time, server image name, or any other attribute of your object. The following attributes are supported by the Quick Search:
- Server Friendly Name: the friendly name of the server
- Load Balancer Friendly Name: the friendly name of the load balancer
- Cloud Storage Hostname: the hostname of your cloud storage allotment
Advanced Search
The Advanced search is available by clicking the Advanced Search button in the left-hand column. The Advanced Search provides the following search terms:
Date Ranges
Selecting the "From Date" and "To Date" icons will enable pop-up calendars for you to enter date ranges. Manual date range entry is also supported. Note that all fields are optional but at least one field is required to perform the job query.
Object Type
This series of check boxes allows you to specify an object type to query your job history. The following objects are supported:
- Virtual server
- Dedicated server
- Load balancer
- Cloud storage
- Server image
Note that you can select multiple check boxes to query jobs that may relate to more than one object type.
State Type
This series of check boxes allows you to specify a state type to query your job history. State types and descriptions are listed above.
