Manage SaaS deployments

Use Xperience Portal (available at https://xperience-portal.com) to manage your Xperience by Kentico applications deployed in the SaaS environment.

You need to upload a deployment package to your Xperience Portal project to trigger an initial deployment to the QA environment. After a successful deployment, you can access the deployed application and manage the SaaS deployments within Xperience Portal, which enables you to:

• Add and configure your content channels.
• Debug the deployments by examining the deployment Logs in the Deployments application.
• Manage backups of your deployed application.
• Monitor the uptime of application deployments and the Xperience Portal project.
• Monitor the event log and exceptions of application deployments.
• Evaluate the performance metrics of your applications.

Access deployed applications

After successfully uploading the deployment package to the QA environment or deploying the package to another deployment environment, use the application URL displayed in the Deployments application under Latest deployments to access the deployed application.

Each project has a default system domain in format: <environment>-<project_code_name>.xperience-sites.com

The default domain can be used to access the project’s administration UI. You can view your project’s default system domains in the Channels and Domains → System domains application in Xperience Portal.

Additionally, projects also have domains for individual website and email channels. You can set up custom domains for website and email channels in the PROD environment. To learn more, see Website channels in the SaaS environment and Email channels in the SaaS environment.

Channel management

Content in Xperience by Kentico is encapsulated within channels, which are bound to specific domains. To allow the content to be presented by deployments in the SaaS environment, you need to add and configure all website and email channels within Xperience Portal in the Channels and Domains application.

For detailed information, see:

• Website channels in the SaaS environment
• Email channels in the SaaS environment
• GraphQL API endpoints

Backups

Backups allow you to restore previous versions of your project for a particular environment.

Xperience Portal creates automatic production backups, and you can also create manual backups for production and non-production environments. Backups can be viewed, managed and restored using the Backups application.

Full and partial backups

Applications deployed in the SaaS environment consist of the following:

• Application service – application binaries and runtime files,
• Database – reflects the current state of the environment’s database,
• Storage and files – reflects the current state of files in the environment’s Azure Blob storage.

When creating a manual backup, you can choose whether to create a full or partial backup.

• Full backups include all of the above components, and can be restored.
• For partial backups, you can select which components are included. Create and download partial backups if you wish to inspect the current state of the application – debug the database or check the integrity, versions, and number of files in the deployment environment.

Automatic production backups

Kentico automatically creates the following full backups:

• For deployments to all environments:
  • Predeployment backups which are retained until overwritten by a new deployment to the given environment.
• For deployments only to the Production environment:
  • Daily backups with a retention policy based on your service plan:
    • Level 1 – 3 days
    • Level 2 – 3 days
    • Level 3 – 7 days
  • Weekly backups with a retention policy of 30 days.

Create a manual backup

You can create manual backups for both production and non-production environments.

The retention policy for manual backups is:

• Full backups:

  • Level 1 service plan – 3 days
  • Level 2 service plan – 3 days
  • Level 3 service plan – 7 days

• Partial backups – 60 hours

  To create a manual backup:

1. Navigate to the Backups application.

2. Select Create backup in the upper-right corner.

3. Select the environment for which you want to create a backup.

   Only Tenant administrator and DevOps roles can access and create backups for the Production environment. See Reference - Xperience Portal user roles.

4. Select whether to create a full backup or select the components you want to include in the partial backup.

5. Select Create and wait for the backup to be created.

   You can have only one backup process running at a time.

Your backup is now available in the Backups application.

Download a backup

1. Navigate to the Backups application.
2. Select an environment and select Apply. A list of backups for the environment is displayed.
3. Download the backup by selecting Download () under Actions.

Downloading backups allows you to inspect the state of the application – debug the database or check the integrity, versions, and number of files in the deployment environment.

If you wish to restore a downloaded backup, contact Kentico support. You cannot directly restore a downloaded backup in Xperience Portal.

Restore a backup

1. Navigate to the Backups application.
2. Select an environment and select Apply. A list of backups for the environment is displayed.
3. Restore the backup by selecting Restore () under Actions next to a full backup.
   • Note: You cannot restore a partial backup.
4. On the Restore a backup page:
   • Select exactly which backup you wish to restore.
   • For production environments, you can upload an “offline” HTML page in the Custom HTML page field.
     • This page is displayed on the live site while the backup is being restored.
     • We recommend creating a page that matches your site’s design and branding.
     • A default offline page is used if you do not add a custom one.

Application monitoring

The Monitoring set of applications in the Xperience Portal are designed to keep your application running smoothly and provide full visibility into your application’s performance, enabling you to quickly detect and resolve issues, optimize performance, and ensure the best possible user experience.

• Uptime monitoring
• Event log and exceptions
• Performance metrics
• Alerts and email notifications

Uptime monitoring

Use the Outages application under Monitoring in Xperience Portal to see a list of outages for your Xperience Portal project and deployed applications. Records include the time when the outage occurred and the cause of the outage. You can filter the outages by the month when they occurred.

Go to status.xperience-portal.com to see the uptime statistics for Xperience Portal. See Xperience Portal uptime statistics.

Xperience Portal uptime statistics

Go to status.xperience-portal.com to see the statistics about the availability of:

• Xperience Portal
• Deployment API
• Production sites by region

You can also see the list of Past incidents below the statistics.

Event log and exceptions

Xperience by Kentico integrates Application Insights for ASP.NET Core applications to enable monitoring and aggregation of metrics for your website. For detailed information about enabling the Application Insights integration for your projects, see Deploy to the SaaS environment.

To view the Application Insights logs for your deployments, use the following applications under Monitoring in Xperience Portal:

• Event log – displays entries from the Xperience event log and any custom messages sent via the Application Insights SDK.
• Exceptions – displays all .NET exceptions (errors) from Application Insights. Includes exceptions that can occur before the Xperience application is fully running, in addition to errors in the Xperience event log.

You can filter the logs for individual deployment environments, and based on the time when the event occurred.

Performance metrics

Use the Metrics application under Monitoring to see various performance metrics related to applications deployed to the SaaS environment. The available metrics include server errors, response time, CPU usage and memory usage. By tracking these metrics, potential issues can be detected and addressed before they impact users, bottlenecks and areas for optimization can be identified, resource utilization can be better understood, and insights can be gained to make data-driven decisions to improve and optimize the application.

To view performance metrics for various SaaS environments:

1. In Xperience Portal, navigate to Monitoring → Metrics.
2. Select an Environment and a Time period, for which you want to display metrics.
3. Apply the changes.

Alerts

Alerts notify about potential problems with applications deployed to the SaaS environment. Most of the available alerts are based on performance metrics, such as application responses, server errors or CPU/memory/DTU utilization.

The system currently provides the following types of alerts:

To view alerts for your project’s deployments, navigate to Monitoring → Alerts in Xperience Portal. You can filter the alerts for individual deployment environments, based on the time when the alert was fired, and the alert severity.

Alerts are displayed with the Resolved flag if the conditions that caused the alert to fire no longer apply. For example, a CPU utilization alert will be resolved after the utilization drops under the 80% threshold for 30 minutes. Select Show active alerts only in the filter if you wish to see only unresolved alerts.

Alert email notifications

Whenever an alert is fired, the system sends a notification email to all Xperience Portal users assigned to the related project.

Individual users can adjust their preferences for receiving alert email notifications:

1. In Xperience Portal, expand the top-right user menu.
2. Select Settings.
3. Under Alert notification emails, clear or select the checkboxes matching the alert severity levels for which you want to receive email notifications – Critical, Error, Warning.
4. Select Apply.