Managing custom views in IBM Cloud Logs

In IBM® Cloud Logs, you can use custom views to monitor logs that match a specific querying criteria.

About views in IBM Cloud Logs

Consider the following information when working with views in IBM Cloud Logs:

  • Views can be public or private.

  • Users with Manager or Writer role for the IBM Cloud Logs service can create and modify custom views.

  • To configure a custom view, you can define a query, filter by selected fields, or both.

  • Views including column configurations are stored as per instance. If you work with multiple IBM Cloud Logs instances, you must configure and save views in each instance separately.

  • You can save column configurations, view mode and layout settings as part of each view and restore automatically when the view is reopened.

  • Views can be grouped into folders. The folder order cannot be changed.

  • View names must be unique within a folder.

  • Each user can configure per IBM Cloud Logs instance a custom view as their default view.

    The user's default view opens automatically when the user launches Explore Logs.

  • The following preferences are saved within saved views. They are restored automatically the next time you open a view:

    Column configuration: The set of fields displayed as columns and their order.

    View mode: Depends on whether the view was last used in standard mode or compact mode. The mode that was active when you last saved the view is restored when you reopen it.

    Query and filters: These are saved only when Save query and filters is selected when you save a view. If not selected, the view opens without any pre applied query or filter.

    Time interval: The time range you selected at the time you save is stored with the view and applied when the view is opened.

  • When you save a view, Tte column configuration, the selected view mode (compact or standard), and the existing layout are saved as part of the view. These settings are restored automatically the next time a view is opened.

  • You must have IBM Cloud® Identity and Access Management permissions to work with private and public views in an IBM Cloud Logs instance. For more information, see Granting permissions to work with views.

Launching views in IBM Cloud Logs

Complete the following steps to see all views in IBM Cloud Logs:

  1. Launch the UI through the IBM Cloud UI.

  2. Click the Explore logs icon Explore logs icon.

  3. Click Logs.

    The last view you had opened will be displayed. If no view was previously open, the default view will be displayed. If you have not set a default view, the instance-level default view configuration is displayed.

Creating a custom view in IBM Cloud Logs

To configure a custom view in IBM Cloud Logs, you can define a query, filter by selected fields, or both.

Complete the following steps to create a custom view in IBM Cloud Logs:

  1. Launch the UI through the IBM Cloud UI.

  2. Click the Explore logs icon Explore logs icon. Then, click Logs.

  3. Select filters to define the data that is displayed through the view. By default you can select Applications, Subsystems, and log Severities.

  4. (Optional) Add additional filters click + Add Filter and select and configure additional field and filter values.

  5. Select what logs you want to view.

    Choose Priority Insights to view logs ingested through the Priority insights pipeline.

    Choose All Logs to view logs that are stored in the IBM Cloud Object Storage data bucket. Logs in IBM Cloud Object Storage includes logs collected through all the data pipelines.

  6. (Optional) Add a Lucene or DataPrime query to further filter your data.

  7. Specify the time interval for the view, for example Last 2 Days.

  8. Configure the columns by clicking the Column icon and selecting the fields you want to display.

  9. Save your view by clicking the three dots ...

    1. Enter a name for your view.

    2. Check Save query and filters to save the query and filter values you configured. When you open the view later, these query and filter values are restored automatically. If this option is not checked, the view opens without any pre-applied query or filter.

    3. Check Set as default view to make this view the default view.

      This sets the view as the default for you as the user. It does not set the view as the default view for the entire account.

      A default view opens automatically the next time your navigate to Explore Logs without a previously open view.

      You can change your default view at any time by opening a different view and checking Set as default view while saving.

    4. Set the privacy of your view. Private views can only be seen by you. You can set a view as Private or Public.

      Private views are visible only to you. Other users cannot see them or open them. Use this setting for personal or experimental views.

      Public views are shared and visible to all users of the instance. Use this setting when you want to share a consistent view with your team.

After you save the view, the view is available in the All Views list.

Updating the column layout in views in IBM Cloud Logs

You can update the column layout of any saved view in IBM Cloud Logs. The column configurations are saved as part of the view.

Complete the following steps to edit the columns of an existing view in IBM Cloud Logs:

  1. Launch the UI through the IBM Cloud UI.

  2. Click the Explore logs icon Explore logs icon. Then, click Logs.

  3. Click All Views and select the view whose columns you want to change.

  4. Click the Columns icon.

    A panel opens listing all the available fields.

  5. Select the fields you want to display as columns. Deselect any fields you want to delete.

  6. (Optional) Reorder columns by dragging the fields to your preferred position.

  7. Save the updated column layout by clicking the three dots ... next to the view name. Select Save query and filters. Then, click Save.

The new column layout is saved as part of the view and is applied the next time the view is opened.

Creating folders in IBM Cloud Logs

The order of the folders cannot be changed in IBM Cloud Logs.

Complete the following steps to create a folder and add saved views to the folder in IBM Cloud Logs:

  1. Launch the UI through the IBM Cloud UI.

  2. Click the Explore logs icon Explore logs icon. Then, click Logs.

  3. Click All Views.

  4. To create a new folder, click the folder icon. Enter a folder name, and click Create.

Orginizing views in folders in IBM Cloud Logs

After you create 1 or more view folders, you can orginize views to folders by dragging them to the folder.

Deleting views in IBM Cloud Logs

Complete the following steps to delete a view in IBM Cloud Logs:

  1. Launch the UI through the IBM Cloud UI.

  2. Click the Explore logs icon Explore logs icon. Then, click Logs.

  3. Click All Views.

  4. Select the view you want to delete.

  5. Click the delete icon.

  6. Confirm that you want to delete the view by clicking Delete.

Deleting folders in IBM Cloud Logs

Folders must be empty before a folder can be deleted.

Complete the following steps to delete a folder in IBM Cloud Logs:

  1. Launch the UI through the IBM Cloud UI.

  2. Click the Explore logs icon Explore logs icon. Then, click Logs.

  3. Click All Views.

  4. Click the folder you want to delete.

  5. Click the delete icon.