|
| 1 | +--- |
| 2 | +id: kaltura |
| 3 | +title: Kaltura |
| 4 | +sidebar_label: Kaltura |
| 5 | +description: The Sumo Logic app for Kaltura allows you to monitor trends, detect changes, and optimize your content strategies within your content management ecosystem. |
| 6 | +--- |
| 7 | + |
| 8 | +import useBaseUrl from '@docusaurus/useBaseUrl'; |
| 9 | + |
| 10 | +<img src={useBaseUrl('img/send-data/kaltura-logo.png')} alt="Thumbnail icon" width="70"/> |
| 11 | + |
| 12 | +The Sumo Logic app for Kaltura offers a comprehensive overview of key metrics within the content management ecosystem, including total entries, user activity trends, and event distributions. It provides visualizations and analytics to help you monitor trends, detect changes, and optimize your content strategies, enabling you to make informed decisions and maintain the security of the platform. |
| 13 | + |
| 14 | +:::info |
| 15 | +This app includes [built-in monitors](#kaltura-monitors). For details on creating custom monitors, refer to the [Create monitors for Kaltura app](#create-monitors-for-kaltura-app). |
| 16 | +::: |
| 17 | + |
| 18 | +## Log types |
| 19 | + |
| 20 | +This app uses Sumo Logic’s [Kaltura Source](/docs/send-data/hosted-collectors/cloud-to-cloud-integration-framework/kaltura-source/) to collect the [base entry events](https://developer.kaltura.com/api-docs/service/baseEntry/action/list) and the [audit trail events](https://developer.kaltura.com/api-docs/service/auditTrail/action/list) from the Kaltura platform. |
| 21 | + |
| 22 | +### Sample log messages |
| 23 | + |
| 24 | +<details> |
| 25 | +<summary>Audit Trail Event Log</summary> |
| 26 | + |
| 27 | +```json |
| 28 | +{ |
| 29 | + "id": 1747229372, |
| 30 | + "createdAt": 1747229372, |
| 31 | + "status": 2, |
| 32 | + "auditObjectType": "accessControl", |
| 33 | + "objectId": "1_accessControl03", |
| 34 | + "entryId": "1_accessControl03", |
| 35 | + "masterPartnerId": 5721612, |
| 36 | + "partnerId": 5721612, |
| 37 | + "requestId": "627081177", |
| 38 | + "userId": "ojames", |
| 39 | + "action": "COPIED", |
| 40 | + "data": { |
| 41 | + "changedItems": [ |
| 42 | + { |
| 43 | + "descriptor": "accessControl.TYPE", |
| 44 | + "oldValue": "restricted", |
| 45 | + "newValue": "unrestricted", |
| 46 | + "objectType": "KalturaAuditTrailChangeItem" |
| 47 | + }, |
| 48 | + { |
| 49 | + "descriptor": "accessControl.RULE", |
| 50 | + "oldValue": "ruleA", |
| 51 | + "newValue": "ruleB", |
| 52 | + "objectType": "KalturaAuditTrailChangeItem" |
| 53 | + } |
| 54 | + ], |
| 55 | + "objectType": "KalturaAuditTrailChangeInfo" |
| 56 | + }, |
| 57 | + "ks": "djJ8NTcyMTYxMnz4000R7odJuJvBFHRM1tsCApuOv-61TnUTXSrSkNRtVdPzuahbx1bkWLP9BfvHxh0wKUV9wlIf1-So-elhmMAageO_XNNFhsQtPNI4x0mpV4PXj1MaDuPqPRQ2sw5f4DevBxdfyEzwMtj8kBRCPts5TLfiEiXSFvhVpsBT_2qdNM4Kz91sSYAzzmVE6XPBIJsxw6Nx-G2Ee0bIVROBV0v19q5GuJK5RA7MU4bggbbvh31T0dpguRGxxVn7LKfD2JGAGJcqY63CMfSbdm6k2nS8iCrMzhwaP5PqC8edsh8IZLejhKyJ6Qf2nopwg0JN17phVuFsgmR6", |
| 58 | + "context": 1, |
| 59 | + "entryPoint": "accessControl::copy", |
| 60 | + "serverName": "nvp1-fapi-rty9", |
| 61 | + "ipAddress": "193.124.185.120", |
| 62 | + "userAgent": "KMS-1223456afe-1747229372.519", |
| 63 | + "clientTag": "KMS 5.150.13, build 0;1223456afe;nvp1-mediaspace-kms-main-777979b8f8-w7kct", |
| 64 | + "objectType": "KalturaAuditTrail" |
| 65 | +} |
| 66 | +``` |
| 67 | +</details> |
| 68 | + |
| 69 | +<details> |
| 70 | +<summary>Base Entry Event Log</summary> |
| 71 | + |
| 72 | +```json |
| 73 | +{ |
| 74 | + "id": "1_qasdad7l4x8yz", |
| 75 | + "name": "Virtual Reality Expo Highlights", |
| 76 | + "description": "A recap of the exciting virtual reality technologies showcased at the expo.", |
| 77 | + "partnerId": 5721612, |
| 78 | + "userId": "mstevens", |
| 79 | + "creatorId": "mstevens", |
| 80 | + "tags": "VR, technology, expo", |
| 81 | + "adminTags": "expo_highlights", |
| 82 | + "categories": "Technology", |
| 83 | + "categoriesIds": "458901234", |
| 84 | + "status": 2, |
| 85 | + "moderationStatus": 6, |
| 86 | + "moderationCount": 0, |
| 87 | + "type": 1, |
| 88 | + "createdAt": 1747229272, |
| 89 | + "updatedAt": 1747229272, |
| 90 | + "rank": 4.4, |
| 91 | + "totalRank": 44, |
| 92 | + "votes": 10, |
| 93 | + "downloadUrl": "https://jaromivaxenox.xyz/p/5721612/sp/0/playManifest/entryId/1_q7l4x8yz/format/download/protocol/https/flavorParamIds/0", |
| 94 | + "searchText": "_PAR_ONLY_ _5721612_ _MEDIA_TYPE_1| Virtual Reality Expo Highlights", |
| 95 | + "version": 1, |
| 96 | + "thumbnailUrl": "https://jaromivaxenox.xyz/p/5721612/sp/0/thumbnail/entry_id/1_q7l4x8yz/version/100011", |
| 97 | + "accessControlId": 7294800, |
| 98 | + "referenceId": "VRExpo2025", |
| 99 | + "replacementStatus": 0, |
| 100 | + "partnerSortValue": 150, |
| 101 | + "conversionProfileId": 25121350, |
| 102 | + "rootEntryId": "1_q7l4x8yz", |
| 103 | + "operationAttributes": [], |
| 104 | + "entitledUsersEdit": "mstevens,rgarcia", |
| 105 | + "entitledUsersPublish": "rgarcia", |
| 106 | + "entitledUsersView": "mstevens,rgarcia,awilliams", |
| 107 | + "capabilities": "", |
| 108 | + "displayInSearch": 1, |
| 109 | + "blockAutoTranscript": false, |
| 110 | + "plays": 80, |
| 111 | + "views": 110, |
| 112 | + "width": 1920, |
| 113 | + "height": 1080, |
| 114 | + "duration": 3000, |
| 115 | + "msDuration": 3000000, |
| 116 | + "mediaType": 1, |
| 117 | + "conversionQuality": 25121350, |
| 118 | + "sourceType": "4", |
| 119 | + "dataUrl": "https://jaromivaxenox.xyz/p/5721612/sp/0/playManifest/entryId/1_q7l4x8yz/format/url/protocol/https", |
| 120 | + "flavorParamsIds": "489001,489002", |
| 121 | + "objectType": "KalturaMediaEntry", |
| 122 | + "application": 0, |
| 123 | + "licenseType": 4 |
| 124 | +} |
| 125 | +``` |
| 126 | +</details> |
| 127 | + |
| 128 | +### Sample queries |
| 129 | + |
| 130 | +```sql title="Entries by Status" |
| 131 | +_sourceCategory="Labs/Kaltura" accessControlId |
| 132 | +| json "id", "status", "type", "objectType", "application", "displayInSearch", "moderationStatus", "replacementStatus", "licenseType", "userId", "name", "description", "creatorId", "dataUrl", "updatedAt" as id, status, type, object_type, application, display_in_search, moderation_status, replacement_status, license_type, user_id, name, description, creator_id, data_url, updated_at nodrop |
| 133 | + |
| 134 | +| where !isNull(application) and !isNull(license_type) |
| 135 | +| lookup status_name as status from https://sumologic-app-data.s3.us-east-1.amazonaws.com/kaltura/kaltura_status_mapping.csv on status=status_code |
| 136 | +| lookup type_name as type from https://sumologic-app-data.s3.us-east-1.amazonaws.com/kaltura/kaltura_type_mapping.csv on type=type_code |
| 137 | +| lookup application_name as application from https://sumologic-app-data.s3.us-east-1.amazonaws.com/kaltura/kaltura_application_mapping.csv on application=application_code |
| 138 | +| lookup display_search_name as display_in_search from https://sumologic-app-data.s3.us-east-1.amazonaws.com/kaltura/kaltura_display_search_mapping.csv on display_in_search=display_search_code |
| 139 | +| lookup moderation_status_name as moderation_status from https://sumologic-app-data.s3.us-east-1.amazonaws.com/kaltura/kaltura_moderation_status_mapping.csv on moderation_status=moderation_status_code |
| 140 | +| lookup replacement_status_name as replacement_status from https://sumologic-app-data.s3.us-east-1.amazonaws.com/kaltura/kaltura_replacement_status_mapping.csv on replacement_status=replacement_status_code |
| 141 | +| lookup license_type_name as license_type from https://sumologic-app-data.s3.us-east-1.amazonaws.com/kaltura/kaltura_license_type_mapping.csv on license_type=license_type_code |
| 142 | + |
| 143 | +| where status matches "{{status}}" |
| 144 | +| where type matches "{{type}}" |
| 145 | +| where application matches "{{application}}" |
| 146 | +| where display_in_search matches "{{display_in_search}}" |
| 147 | +| where moderation_status matches "{{moderation_status}}" |
| 148 | +| where replacement_status matches "{{replacement_status}}" |
| 149 | +| where license_type matches "{{license_type}}" |
| 150 | +| where object_type matches "{{object_type}}" |
| 151 | + |
| 152 | +| count by id, status |
| 153 | +| count by status |
| 154 | +| sort by _count, status |
| 155 | +``` |
| 156 | + |
| 157 | +## Collection configuration and app installation |
| 158 | + |
| 159 | +import CollectionConfiguration from '../../reuse/apps/collection-configuration.md'; |
| 160 | + |
| 161 | +<CollectionConfiguration/> |
| 162 | + |
| 163 | +:::important |
| 164 | +Use the [Cloud-to-Cloud Integration for Kaltura](/docs/send-data/hosted-collectors/cloud-to-cloud-integration-framework/kaltura-source/) to create the source and use the same source category while installing the app. By following these steps, you can ensure that your Kaltura app is properly integrated and configured to collect and analyze your Kaltura data. |
| 165 | +::: |
| 166 | + |
| 167 | +### Create a new collector and install the app |
| 168 | + |
| 169 | +import AppCollectionOPtion1 from '../../reuse/apps/app-collection-option-1.md'; |
| 170 | + |
| 171 | +<AppCollectionOPtion1/> |
| 172 | + |
| 173 | +### Use an existing collector and install the app |
| 174 | + |
| 175 | +import AppCollectionOPtion2 from '../../reuse/apps/app-collection-option-2.md'; |
| 176 | + |
| 177 | +<AppCollectionOPtion2/> |
| 178 | + |
| 179 | +### Use an existing source and install the app |
| 180 | + |
| 181 | +import AppCollectionOPtion3 from '../../reuse/apps/app-collection-option-3.md'; |
| 182 | + |
| 183 | +<AppCollectionOPtion3/> |
| 184 | + |
| 185 | +## Viewing Kaltura dashboards |
| 186 | + |
| 187 | +import ViewDashboards from '../../reuse/apps/view-dashboards.md'; |
| 188 | + |
| 189 | +<ViewDashboards/> |
| 190 | + |
| 191 | +### Entries Overview |
| 192 | + |
| 193 | +The **Kaltura - Entries Overview** dashboard provides a detailed view of content management metrics, including total and active entries, categorized by status, type, application, and moderation status. Using visualizations like pie charts and bar graphs, it helps you track entry distribution, identify trends, and optimize content strategies. Insights into virus-infected entries, flagged actions, and top license types support informed decision-making and help maintain data integrity within the Kaltura platform. |
| 194 | + |
| 195 | +<img src={useBaseUrl('https://sumologic-app-data-v2.s3.us-east-1.amazonaws.com/dashboards/Kaltura/Kaltura+-+Entries+Overview.png')} alt="Entries Overview dashboard" /> |
| 196 | + |
| 197 | +### Audits Overview |
| 198 | + |
| 199 | +The **Kaltura - Audits Overview** dashboard provides a clear view of audit trail data, highlighting key metrics like total events, actions, and contextual details. Visualizations such as pie charts and bar graphs display event distributions by action, context, status, and critical object changes. You can identify anomalies, monitor user behavior, and improve security by analyzing trends, user activity, and geographical data. The dashboard supports informed decision-making and helps optimize auditing processes within the Kaltura platform. |
| 200 | + |
| 201 | +<img src={useBaseUrl('https://sumologic-app-data-v2.s3.us-east-1.amazonaws.com/dashboards/Kaltura/Kaltura+-+Audits+Overview.png')} alt="Audits Overview dashboard" /> |
| 202 | + |
| 203 | +## Create monitors for Kaltura app |
| 204 | + |
| 205 | +import CreateMonitors from '../../reuse/apps/create-monitors.md'; |
| 206 | + |
| 207 | +<CreateMonitors/> |
| 208 | + |
| 209 | +### Kaltura monitors |
| 210 | + |
| 211 | +| Name | Description | Trigger Type (Critical / Warning / MissingData) | Alert Condition | |
| 212 | +|:--|:--|:--|:--| |
| 213 | +| `Events from Embargoed Locations` | This alert is triggered when events originating from embargoed locations are detected, ensuring adherence to security restrictions and protocols. | Critical | Count > 0 | |
| 214 | +| `Infected Entry Detected` | This alert is triggered when entries are marked and flagged as infected, indicating potential security threats and content integrity issues. | Critical | Count > 0| |
| 215 | +| `Virus Scan Failed Entry Detected` | This alert is triggered when virus scans fail on entries, highlighting vulnerabilities and possible malware presence within the platform. | Critical | Count > 0| |
| 216 | +| `Critical Object Changes` | This alert is triggered when critical changes occur in essential object types, ensuring system integrity and security. | Critical | Count > 0| |
| 217 | + |
| 218 | +## Upgrade/Downgrade the Kaltura app (Optional) |
| 219 | + |
| 220 | +import AppUpdate from '../../reuse/apps/app-update.md'; |
| 221 | + |
| 222 | +<AppUpdate/> |
| 223 | + |
| 224 | +## Uninstalling the Kaltura app (Optional) |
| 225 | + |
| 226 | +import AppUninstall from '../../reuse/apps/app-uninstall.md'; |
| 227 | + |
| 228 | +<AppUninstall/> |
0 commit comments