SugarCRM SupportProduct GuidesSugarCloud ServicesSugarCloud InsightsSugarCloud Insights Guide

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 via Admin > SugarCloud Insights. The SugarCloud Insights page displays information specific to your Sugar account broken up into three sections: Storage Usage, License Usage, and Error and Access Logs.
SCI AdminPage SugarCloudInsights

Note: The SugarCloud Insights service is only available for SugarCloud customers. 

Accessing SugarCloud Insights

Sugar administrators can access the SugarCloud Insights page by navigating to Admin > SugarCloud Insights from their Sugar instance. Please note that you will automatically be authenticated in SugarCloud Insights because you have an active Sugar session. Alternatively, for instances that use SugarIdentity, you can also navigate directly to the SugarCloud Insights page via URL, which can be found in the browser's address bar when accessing SugarCloud Insights. You will need to enter your tenant ID and Sugar credentials to log in and access the SugarCloud Insights page.

Storage Usage

Customers with instances hosted in Sugar's cloud environment are subject to file system (FS) and database (DB) storage limits and sandbox limits depending on the product(s) (e.g., Sugar Serve) their organization has purchased from SugarCRM. The maximum amount of Managed 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).

For more information on the file system and database storage allowances for each Sugar product (e.g., Sugar Serve) and how the managed storage gets calculated, refer to the SugarCloud Policy Guide and this SugarClub blog post. For more information regarding the sandbox limits for each product, refer to the SugarCloud Sandboxes page. 

The Storage Usage section of the SugarCloud Insights page displays two tables that provide a summary of your current file system and database storage usage across your SugarCloud instances.
SCI FileSystem DB StorageUsage1

The table displays the total file system and database storage amount used along with the storage usage bar and breakdown of storage usage: 

  • Total Storage Used: Above the storage usage bar is the total amount of file system and database 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 file system and database storage being used.
  • Storage Usage Bar: Above the storage usage table is a segmented bar colored to represent the file system and database storage amount used for each of your cloud instances (i.e., production, sandbox).
  • Storage Usage Details: Below the usage bar is a breakdown of the current file system and database storage usage in gigabytes and as a percentage for each of your SugarCloud instances.
    Table Header Description
    Instance The customer's production and sandbox instances hosted on Sugar's Cloud service 
    File System The current file system storage usage in gigabytes/megabytes for each instance 
    Database The current database storage usage in gigabytes for each instance
    Percentage The percentage of the file system/database storage allowance used by each instance

When the amount of managed storage being used exceeds the storage capacity allocated by your Sugar subscription, you will see the amount of storage exceeding the limit, in red, as shown below. To purchase additional file system or database storage, please contact SugarCRM or your Sugar partner. For more information on managing your storage usage, refer to the SugarCloud Managed Storage Limits page. 
SCI StorageUsage Overage

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 Advanced, 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 Advanced), 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 Advanced). 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.

SCI LicenseUsageDetails

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 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 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. 
SCI PHPErrorLog AccessLog

Last modified: 2022-07-26 14:16:36