SugarCloud Insights Guide
Customers with instances hosted in Sugar's cloud environment can easily monitor their instance's database and file system storage usage, license usage, as well as gain access to PHP error logs and access logs. Sugar administrators can access this pertinent information by navigating to the Admin page and clicking "SugarCloud Insights" in the SugarCloud section. The SugarCloud Insights page will open in a new browser tab and display information specific to your Sugar account broken up into three sections: Database and File System Storage, License Usage, and Error and Access Logs.
Note: The SugarCloud Insights service is only available for SugarCloud customers.
Database and File System Storage
Customers with instances hosted in Sugar's cloud environment are subject to cloud storage and sandbox limits depending on the product(s) (e.g., Sugar Serve) their organization has purchased from SugarCRM. For more information regarding the storage and sandbox limits for each product, refer to the SugarCloud Disk Space Limits article and SugarCloud Sandboxes page. The maximum data storage allowance for your SugarCloud subscription encompasses the database and files belonging to the main production instance plus any of your Sugar-hosted test instances (i.e., sandboxes).
The maximum amount of storage and sandbox allowances for each Sugar product are as follows:
|Included Cloud Services||Sell||Serve||Professional||Enterprise||Ultimate|
|Cloud Storage Limits 1||60GB||60GB||15GB||60GB||250GB|
|Cloud Sandbox Instances 2||2||2||0||2||5|
1 Storage limits apply as a cumulative total across all production and sandbox instances. Additional storage can be purchased.
2 Additional cloud sandboxes can be purchased.
Note: When an organization has purchased more than one product, such as Sugar Serve and Sugar Sell, the maximum storage allowance will be based on the higher storage limit. So, for example, if you have Sugar Sell and Sugar Serve, your cloud storage limit will be 60GB while for Sugar Ultimate and Sugar Serve, the limit will be 250GB.
The Database and File System Storage section of the SugarCloud Insights page provides a summary of your current database and file system storage usage for your cloud instances as follows:
- Total Storage Used: Displays the total amount of storage currently being used across your SugarCloud instances versus your allowed storage limit in gigabytes. The number in parentheses represents the total percentage of your allowed cloud storage being used.
- Storage Usage Bar: Shows a segmented bar colored to represent the storage amount used for each of your cloud instances (i.e., production, sandbox).
- Storage Usage Details: Shows a breakdown of the current database and file system storage usage for each of your cloud instances as well as the total storage amount used in gigabytes and as a percentage.
Table Header Description Instance The customer's production and sandbox instances hosted on Sugar's Cloud service Total The total file system and database storage usage in gigabytes for each instance Database The current database storage usage in gigabytes for each instance File System The current file system storage usage in gigabytes for each instance Percentage The percentage of the total storage allowance used by each instance
When the amount of storage being used exceeds the storage capacity allocated by your Sugar subscription, you will be notified of the overage as follows:
- A warning message will appear indicating that the storage size exceeds the maximum storage limits, and the amount of storage exceeding the limit will display in red.
- The total storage amount being used (e.g., 85.5 GB) will display in red to indicate that it exceeds the limit.
- The amount of storage that you have exceeded the limit by will be outlined using red dotted lines on the storage usage bar.
A warning message will also appear asking you to contact your sales representative or email email@example.com in order to purchase additional storage.
Your Sugar subscription is purchased with a set number of user seats that allow users to access the application, and all active system administrators and regular users count towards the licensed user limits. Please note that inactive users, Group users, and Portal API users do not count towards the limits. If your instance has more active users of a particular license type (e.g., Sugar Serve) than is allowed by your Sugar license, regular users will not be able to log in and a warning will display. Admin users will be able to log in but will be redirected to the Users module. Once they have deactivated enough users, reduced the number of users assigned to the license type(s) exceeding the limit, or purchased additional seats, regular users will be able to log in again. For more information on how Sugar's licensed user limits work, refer to the Understanding User Types, License Types, and Sugar Licenses article.
The License Usage section of the SugarCloud Insights page allows administrators to have better visibility of their Sugar license usage and be able to easily monitor the number of active users counting against their license to ensure that they do not exceed their limit. It shows a breakdown for each license type (e.g., Sugar Serve, Sugar Sell, Sugar Enterprise) purchased with your Sugar subscription and provides the following information:
Note: If an active user is assigned to multiple license types (e.g., Sugar Serve, Sugar Sell), they will count against each license type.
- License Expiration Date: Displays the date that your Sugar license is due to expire.
- Total User Count: Displays the total number of current active users versus the total number of users allowed for the particular license type (e.g., Sugar Serve, Sugar Sell, Sugar Enterprise). The number in parentheses represents the total percentage of active users.
- User Count Bar: Shows a segmented bar colored to represent the total number of active admin and regular users for the particular license type.
- User Count Details: Shows a breakdown of the total number of active admin and regular users for the particular license type. The Percentage column shows the total percentage of active users for each user type.
When the number of active users exceeds the number of purchased licenses, you will be notified of the overage as follows:
- A warning message will appear for the particular license type (e.g. Sugar Serve) indicating that the current user count exceeds your license limit, and the number of users exceeding the limit will display in red.
- The total number of active users will display in red to indicate that it exceeds the limit.
- The number of users exceeding your license limit will be outlined using red dotted lines on the user count bar.
A warning message will also appear asking you to deactivate some users or contact your sales representative or email firstname.lastname@example.org to purchase additional seats.
Error and Access Logs
The Error and Access Logs section of the SugarCloud Insights page gives administrators the ability to generate PHP error and access logs for their production instance of Sugar. Occasionally, you may encounter an error or unexpected behavior in Sugar such as the page not loading properly or customizations not behaving correctly. When issues such as these occur, the PHP error log can come in handy as it can provide information that may help in troubleshooting the issue. The Message column in the error log file will contain different types of messages (e.g., fatal, warnings, notices) summarizing the possible cause of the issue.
Access logs can be used to examine HTTP requests to the instance and help provide useful information when troubleshooting third-party connectors. From the access log, you can view the API endpoints being called, the useragent making the request, the type of request (i.e., method), the response (i.e., status code), and the IP address of the HTTP request. For example, if you have a lead generation integration on your website and testing indicates that leads are not being created in your Sugar instance, you can generate the access log and look for the IP address of your website to see if the HTTP requests from that website are successfully submitted to your instance.
Note: The Sugar Support team already has access to the PHP error and access logs, so you will only need to provide the specific error or access log entry when working with them to troubleshoot an issue.
To generate a PHP error log or access log, simply click the "Request Error Log" or "Request Access Log" button which will begin processing your request. The timestamp of your request will appear in the Timestamp section, and once your request is complete, you can click the Download link to download the log file. Please note that you can only generate error and access logs for the last 24 hours or up to a limit of 10,000 entries per log file type, whichever comes first. If you need to request additional logs beyond the 10,000 entries or need log files for a specific time period, please file a case with the Sugar Support team for further assistance.
Once you have requested an error or access log, please note that you will need to wait 15 minutes before you can put in a new request. The SugarCloud Insights page will display the 10 most recent logs for each log file type (i.e., PHP Error Logs, Access Logs) that have been generated in the last 30 days.
Last modified: 2021-10-22 17:32:35