Splunk Cloud

Splunk Cloud User Manual

Download manual as PDF

Download topic as PDF

Manage private apps in your Splunk Cloud deployment

Private apps are Splunk apps that are private to your Splunk Cloud deployment. These apps are not publicly available on Splunkbase. Like all Splunk apps, private apps must be approved by Splunk to be installed on your Splunk Cloud deployment. Splunk uses the validation tool AppInspect to determine if apps comply with the security requirements of Splunk Cloud. For information about AppInspect, see Splunk Appinspect tool on the Splunk developer portal.

In managed Splunk Cloud deployments, you can use Splunk App Management to manage and install private apps. You must be a Splunk Cloud administrator to manage and install private apps in your Splunk Cloud deployment. In self-service Splunk Cloud deployments, the Splunk App Management feature is not available. File a Support ticket to install private apps.

Create a private app

Prerequisites

Steps

  1. Create an app that conforms to Splunk app standards and requirements.
  2. Make sure the app package does not have any static dependencies, because only dynamic dependencies are supported.
  3. Package the app as a .tgz, .spl, .zip or .gz file. Keep the package size limited to 128MB.
  4. Run the app through AppInspect and make sure it passes all app validation checks.

The file is ready to installed on your Splunk Cloud deployment. If you have a managed Splunk Cloud deployment, you can install and manage your private app yourself. If you have a self-service Splunk Cloud deployment, file a Splunk Support ticket to proceed. If you aren't sure whether your Splunk Cloud deployment is self-service or managed, see Types of Splunk Cloud deployment.

Upload and manage private apps in managed Splunk Cloud deployments

In a managed Splunk Cloud deployment, you can upload, install, update, and view reports for your private apps.

Upload a private app

  1. In Splunk Web, click the Apps gear.
  2. Click the Uploaded Apps tab.
  3. Click Upload App.
  4. Enter your splunk.com credentials. These credentials are used to authenticate with AppInspect.
  5. Select the consent check box and click Login.
  6. Select the private app package that you created.
  7. Click Upload.

This uploaded package is private to your Splunk Cloud deployment. It is stored in your Splunk Cloud deployment and not on Splunkbase.

When the package is uploaded successfully, it appears in the table on the Uploaded Apps page. The app name and version appear only when the package passes all AppInspect checks and is approved. This screen image shows the Uploaded Apps view with several private apps listed, showing the different possible statuses of those apps: approved, installed, rejected, vetting, and app validation failed to complete.

The Uploaded Apps table provides the following information:

Column Description
App If the package is approved, the app name is displayed.
If the package is not approved, the file name of the uploaded package is displayed.
Status Displays the status of the package in the validation process.
For details, see the next section, Status.
Actions Shows what actions you can take on the package.
Date Submitted Shows when the package was uploaded.
Version If the package is approved, the app version is displayed.
If the package is not approved, N/A is displayed.

Status

Based on the result of the app validation process, status can be one of the following:

  • Vetting – Package is in the validation process.
  • Approved – Package has passed all AppInspect checks and is ready to be installed.
  • Installed – Package is installed on your Splunk Cloud deployment.
  • Rejected – Package did not pass AppInspect checks. This means that either some checks failed, or some manual checks were detected that must be reviewed by the Splunk AppInspect team. Click View Report to see which checks failed.
  • Failed message – Package validation did not complete due to some issues, for example, issues with the AppInspect service. Click More Info to find out why the package failed validation.

Install a private app

  1. Use the Uploaded Apps table to verify that the status of your package is Approved. Your package must be approved before you can install it.
  2. Click Install to install your private app.
  3. Click the Apps tab to see that your private app is listed in the Apps table. You can also see that the value for App Origin is Uploaded.

Update a private app

  1. If you are installing an earlier version, uninstall the currently installed app.
  2. Upload your private app.
  3. Verify that the app status is Approved in the Uploaded Apps table.
  4. Click Install to install an earlier version. Click Update to replace an installed app with a later version.
  5. Go to the Apps tab to see that the later version of your private app is listed in the Apps table.

View Report of a private app

  1. Click View Report to see the AppInspect report for your package.
  2. Use this report to find out why AppInspect rejected the package.
  3. Make the required changes to the package and try uploading again.
PREVIOUS
Install apps in your Splunk Cloud deployment
  NEXT
Manage a rolling restart in Splunk Cloud

This documentation applies to the following versions of Splunk Cloud: 7.1.3, 7.1.6, 7.2.3, 7.2.4, 7.2.6, 7.2.7


Was this documentation topic helpful?

Enter your email address, and someone from the documentation team will respond to you:

Please provide your comments here. Ask a question or make a suggestion.

You must be logged into splunk.com in order to post comments. Log in now.

Please try to keep this discussion focused on the content covered in this documentation topic. If you have a more general question about Splunk functionality or are experiencing a difficulty with Splunk, consider posting a question to Splunkbase Answers.

0 out of 1000 Characters