User Guide: Access and Use Apps
Preview Feature
This Preview feature is still being developed. We do not recommend using it in a production environment, because the feature might not be fully tested or optimized for performance, and related documentation could be incomplete.
Please continue to submit feedback through normal Cribl support channels, but assistance might be limited while the feature remains in Preview.
Use this guide to find, launch, and use Apps installed in your Cribl.Cloud Organization.
In the App Platform (Preview), if you can see an App in the Apps list, you can open and use it. For who can create, install, and run Apps, see Roles, permissions, and governance in the Admin Guide.
Find and Open Apps
Apps appear in Cribl after an administrator installs them. For how packages are imported, see Install an App in the Admin Guide. To access installed Apps, open a Cribl product and use the top bar.
The Apps bar next to Apps shows the first six installed Apps. Select any of those entries to open that App directly.
Select Apps to open the full inventory. The table lists every installed App. Each row includes:
- Display name: Name and optional description.
- ID: Unique identifier.
- Source: The origin of the installed package, file name or URL used during installation.
- Version: The installed version.
- Author: Who built the App.
Select an App from the table to open it. The App loads in the main content area and hides the standard Cribl sidebar so you get a full screen. To return to the main Cribl UI, use the top bar options.
Configure App Settings
App Settings is Administrator-only. Members who run an App do not see App Settings in the Apps inventory or inside the App. If an App needs hosted keys, secrets, or outbound API review, ask an Administrator.
Administrators open App Settings in either of these ways:
- In the Apps inventory, select Settings on the App’s row.
- Or open the App, then select the Settings (gear) icon in the App toolbar.
The App Settings screen has two tabs only: Key-Value Stores and External API Access. There are no other panels on this screen.
- Key-Value Stores: List, add, edit, or delete KV keys and values for this App. Changes apply Organization-wide for this App’s KV namespace. Add API keys and tokens only as encrypted entries.
- External API Access: Review how outbound calls to external APIs are governed for this App and your Organization. Outbound access is on by default. The App must still declare external hosts in
proxies.yml.
For quotas, seeding, and related procedures, see Manage App Settings and External API access in the Admin Guide.
Bookmark and Share App Links
Apps support deep linking when the builder uses a router that syncs in-App routes to the browser URL. As you move through an App’s tabs or multi-step workflows, the address bar usually updates to reflect your location.
In Safari, in-memory routing keeps the browser URL stable while you move inside the App. Shared links and bookmarks open the App entry screen. See Browser Support.
A typical App URL looks like this:
/apps/a/my-app/settings/general?tab=advanced
You can bookmark these URLs to return to the same view later, or copy and share them with teammates. When a teammate opens the link, Cribl restores the App state as long as they have permission to view it.
Understand Permissions and Errors
Apps run API calls with your existing Cribl permissions. They do not grant extra access. If you cannot perform an action in the Cribl UI, the App cannot perform it for you. For the full access model, see Roles, permissions, and governance in the Admin Guide.
Common Permission Scenarios
| What You See | What It Means | Next Steps |
|---|---|---|
| “You don’t have permission” or a 403 error | Your role cannot access the resource the App is calling. | Ask your administrator for the required roles. |
| Disabled buttons or grayed-out actions | The App detected that you lack write access and disabled the action. | You can still view data, but you cannot make changes. |
| Partial data (for example, only some Worker Groups are visible) | You can access only a subset of resources. | This is expected. The App shows only what you are allowed to see. |
| Empty state with no data | Either no data exists yet, or you cannot view it with your current permissions. | Ask your administrator if you expected to see data here. |
If you are unsure which permissions an App needs, check the App’s first-run screen or contact the person who built it.
Troubleshooting Quick Reference
| Problem | Resolution |
|---|---|
| You see the Apps page, but not the App you need | The App is not installed, or your role cannot view it. Contact your administrator. |
| The App opens but shows an empty screen | Try a full page reload. If it still happens, the App might have a defect. Report it to your administrator or the App builder. |
| A shared deep link does not load correctly | The link might point to a state you cannot access, or the App version changed after the link was created. Open the App from the Apps table instead. |