Sumo Collection app

[amee-sumo]

Purpose of this pull request

This pull request is to create a new app doc for Sumo Collection.

Select the type of change

• Minor Changes - Typos, formatting, slight revisions
• Update Content - Revisions, updating sections
• New Content - New features, sections, pages, tutorials
• Site and Tools - .clabot, version updates, maintenance, dependencies, new packages for the site (Docusaurus, Gatsby, React, etc.)

Ticket (if applicable)

https://sumologic.atlassian.net/browse/DOCS-779

[kimsauce]

Hi @amee-sumo ,

• Source doc. It says both Installed and Hosted Collectors are supported, and doesn't seem like it's specific to C2C. If this is true, you'll need to move to a higher tier folder like https://help.sumologic.com/docs/send-data/collection or https://help.sumologic.com/docs/send-data/collect-from-other-data-sources/.

• Apps doc. It doesn't sound like it's specific to SaaS, but other categories as well? If that's true, please place this doc with the other Sumo-branded apps under https://help.sumologic.com/docs/integrations/sumo-apps.

• Both docs. How does this functionality differ from Health Events? I'd clarify and suggest cross-linking the app and source doc to Health Events docs:

  • https://help.sumologic.com/docs/manage/health-events
  • https://help.sumologic.com/docs/api/health-events

[amee-sumo]

Hi @amee-sumo ,

• Source doc. It says both Installed and Hosted Collectors are supported, and doesn't seem like it's specific to C2C. If this is true, you'll need to move to a higher tier folder like https://help.sumologic.com/docs/send-data/collection or https://help.sumologic.com/docs/send-data/collect-from-other-data-sources/.

• Apps doc. It doesn't sound like it's specific to SaaS, but other categories as well? If that's true, please place this doc with the other Sumo-branded apps under https://help.sumologic.com/docs/integrations/sumo-apps.

• Both docs. How does this functionality differs from Health Events? I'd clarify and suggest cross-linking the app and source doc to Health Events docs:

  • https://help.sumologic.com/docs/manage/health-events
  • https://help.sumologic.com/docs/api/health-events

Thank you @kimsauce for noting this crucial point. I'll connect with @shivani-sumo on this and update the docs as needed.

[shivani-sumo]

@kimsauce @amee-sumo,

The app is used to visualize data fetched from Sumo's API. And given information Installed and Hosted Collectors are supported is part of the corresponding C2C's configuration.

Hence, this app is the same as other security apps. We do not need to show anything extra.

Also, regarding health events.
The doc below shows a list of health events' API., which is not for app customers.
https://help.sumologic.com/docs/api/health-events/

And below, one is informative for the customer.
https://help.sumologic.com/docs/manage/health-events/

[kimsauce]

@kimsauce @amee-sumo,

The app is used to visualize data fetched from Sumo's API. And given information Installed and Hosted Collectors are supported is part of the corresponding C2C's configuration.

Hence, this app is the same as other security apps. We do not need to show anything extra.

Also, regarding health events. The doc below shows a list of health events' API., which is not for app customers. https://help.sumologic.com/docs/api/health-events/

And below, one is informative for the customer. https://help.sumologic.com/docs/manage/health-events/

Thanks, @shivani-sumo ! That helps clarify the internal implementation. Just to confirm, are we saying the source doc is only applicable to C2C environments? If it applies more broadly (e.g., any environment using Installed/Hosted Collectors), it may still make sense to move it up a level in the folder structure.

And while the app isn't a Health Events interface per se, would you be okay with adding a cross-link like "For related info on collector health events, see this doc." to help orient users and improve discoverability of related resources?

[shivani-sumo]

@kimsauce,

Just to confirm, are we saying the source doc is only applicable to C2C environments? If it applies more broadly (e.g., any environment using Installed/Hosted Collectors), it may still make sense to move it up a level in the folder structure.

The given source doc is only applicable to C2C environments.

And while the app isn't a Health Events interface per se, would you be okay with adding a cross-link like "For related info on collector health events, see this doc." to help orient users and improve discoverability of related resources?

Yes, we can add this health events-related reference doc.

[kimsauce]

@kimsauce,

Just to confirm, are we saying the source doc is only applicable to C2C environments? If it applies more broadly (e.g., any environment using Installed/Hosted Collectors), it may still make sense to move it up a level in the folder structure.

The given source doc is only applicable to C2C environments.

And while the app isn't a Health Events interface per se, would you be okay with adding a cross-link like "For related info on collector health events, see this doc." to help orient users and improve discoverability of related resources?

Yes, we can add this health events-related reference doc.

Thanks for clarifying! Can you please see this suggested edit? #5250