SugarCRM SupportDocumentationSugarCloud ServicesSugarCloud InsightsSugarCloud Insights Guide

SugarCloud Insights Guide

Overview

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.
SugarCloudInsights AdminPage

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 0 2

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

SugarCloudInsights DBFileSystemStorage1

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 sales@sugarcrm.com in order to purchase additional storage.
SugarCloudInsights StorageOverage

License Usage

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.

SugarCloudInsights LicenseUsage Per LicenseType2

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 sales@sugarcrm.com to purchase additional seats. 
SugarCloudInsights LicenseUsage Overage4

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. If you need to request 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 a maximum of 10 rows per log file type (i.e. PHP error logs, access logs) from the last 30 days. 
SugarCloudInsights PHPErrorAccessLogs4
 

Last modified: 2019-08-07 18:30:22