Client area Open a ticket
Documentation

Monitoring and troubleshooting

5 min read Updated From the StackRegent manual

StackRegent gives you several tools for keeping an eye on the server. This page covers each of them, from the Home dashboard to the Service Monitor on the server itself.

Home#

Home shows CPU, memory, the main disk and the number of running services at the top. If a service set to start automatically is not running, a warning appears with a link to Services Management. Below that are these widgets: Advisor, SSL/TLS certificates (certificates that expire within 30 days), Subscriptions with overuse, My subscriptions, a 24-hour CPU and memory chart, Server information, the StackRegent version with Check for updates, Disks, Recent tasks, Last server backup and What's new. Click Customize to hide widgets or change their order. This choice is kept in your browser.

Statistics#

Server Management › Statistics has three tabs:

  • Overview: server details, uptime, CPU load, memory and disks. It also shows domain and account counts, and this month's disk use and website traffic.
  • Traffic: website traffic for a month, By subscription, By website, By customer or By reseller.
  • Settings: Keep statistics for (months), and which Traffic that counts towards the subscription limit: incoming and outgoing, outgoing only, or incoming only.

Click Recalculate to measure disk usage and web statistics now. Website traffic is counted from IIS every minute.

Monitoring and alerts#

Server Management › Monitoring collects figures every minute. Choose a range from 1 hour to 1 year.

  • Server tab: CPU, memory, disk activity, disk space per drive, network, IIS requests and connections, the mail queue, and database connections.
  • Websites tab: choose a subscription to see its application pool's CPU and memory, and each website's requests and traffic.
  • Alerts tab: email alerts.

To set up alerts:

  1. Open the Alerts tab and tick Send alerts.
  2. Tick Alert when a service that starts automatically stops for two minutes if you want service alerts.
  3. Under Send to, enter one address per line. Leave it empty to use your profile's address.
  4. For each rule, set the threshold under Goes over and the minutes under For. The rules are CPU usage, Memory usage, Disk space used, Messages waiting in the mail queue, IIS current connections, MariaDB connections and SQL Server connections.
  5. Click Save, then Send a test alert.

When a value returns to normal, a second email says so. Recent alerts shows whether each alert was emailed. Alerts are sent the way outgoing mail is set up in Mail Server Settings.

Advisor#

Tools & Settings › Advisor (under Assistance and Troubleshooting) rates the server with a grade and a score out of 100. It checks things like updates, SSL, PHP, backups, the firewall and the WAF. Items that need attention come first. Click Fix to apply a one-click fix, or Open to go to the page where you can fix it yourself.

Diagnose & Repair#

Tools & Settings › Diagnose & Repair checks the installation, services, websites (IIS), mail, DNS, databases and NTFS permissions.

  1. Click Check Everything. It takes about a minute.
  2. Areas with problems open by themselves. Each finding is marked OK, Warning or Problem.
  3. Tick the findings that can be repaired, then click Repair Selected.
  4. To check one area again, click Check again next to it.

Process List#

Tools & Settings › Process List shows every program running on the server, with PID, user, CPU, memory, threads and start time. Click a column heading to sort, and filter by name, user or PID. It refreshes every 5 seconds. Click End to stop a process. A service you end here may start again by itself.

Services Management#

Tools & Settings › Services Management (under Server Management) lists the Windows services StackRegent manages, grouped by area, with their state, startup type and process ID.

  • Tick services and click Start, Stop or Restart, or use the icons on a row.
  • Click the startup type to choose Automatic, Automatic (delayed start), Manual or Disabled.
  • Tick Show services not installed yet to see the full list.

The panel's own services cannot be stopped here. Use the Service Monitor on the server for that.

Task Manager#

The panel runs longer work as tasks. Open Task Manager from the icon at the top of the panel or from Tools & Settings. Filter by Running, Queued, Success or Failure, or search the descriptions. Click a task to read its log, which updates as it runs. A failed task has a Retry button. If a task stays Queued, check that the StackRegent Task Manager service is running.

Event Manager#

Tools & Settings › Event Manager runs a command when something happens in the panel.

  1. Click Add handler.
  2. Under Event, enter an event name such as subscription.created. Use subscription.* for every action on an object, or * for every event.
  3. Enter the Command, a Priority (0 runs first, 100 last) and a Description. Tick Run this handler, then click Save.

Commands run as SYSTEM through cmd.exe and appear in Task Manager. They receive the environment variables STACKREGENT_EVENT, STACKREGENT_OBJECT_TYPE, STACKREGENT_ACTION, STACKREGENT_ACTOR, STACKREGENT_IP, STACKREGENT_DETAILS and STACKREGENT_TIME.

Scheduled Tasks#

Tools & Settings › Scheduled Tasks holds server tasks. These run as Local System. The page also lists the tasks of every subscription.

  1. Click Add Task and choose the Task type: Command, URL or PHP script.
  2. Enter the command, address or script. For a PHP script, you can also enter the Arguments and the PHP version.
  3. Under Run, choose a preset or Custom (cron expression). The next run times are shown.
  4. Set Send the output by email (Only when the task fails, After every run or Never) and the Time limit. Then click Add Task.

Use Run Now to run a task right away, and History to see past runs with their output. A subscription's own tasks are on its Scheduled Tasks page and run as its system user.

Service Monitor (on the server)#

The StackRegent Service Monitor is a tray app for the server console or a Remote Desktop session. It starts when an administrator logs on. You can also start it from Start › StackRegent › StackRegent Service Monitor. It is not installed on Server Core.

  • Tick services, then click Start, Stop or Restart. This includes the panel's own services.
  • Start StackRegent website and Stop StackRegent website control the panel itself.
  • Delete Sessions logs out everyone who is logged in to the panel.
  • The tray menu has Open StackRegent panel in browser and Restart StackRegent panel.

Use it when the panel does not answer in the browser.

Was this article helpful?

Something missing? Ask in the community or open a ticket.