appcenter-docs icon indicating copy to clipboard operation
appcenter-docs copied to clipboard

Exporting multiple apps to the same storage account <- incomplete documentation

Open Tommigun1980 opened this issue 4 years ago • 1 comments

Hi.

The section "Exporting multiple apps to the same storage account" says "When configuring export for multiple apps, you should create or update a configuration with the blob_path_format_kind (part of the ExportBlobConfiguration model) set to WithAppId, which prefixes the export path with the respective appID's.".

It jumps over all the necessary details and jumps straight into explaining some configuration variables. It assumes the user already knows how this works, but that's kinda the point with documentation, it should outline these things.

  1. How do you configure export for multiple apps - by using the same connection string?
  2. Where should one create this "configuration with blob_path_format_kind set to WithAppId"? The only advanced option is the connection string/instrumentation key.
  3. Can you export multiple apps (iOS + Android) into the same Application Insights resource? It doesn't say.
  4. Some page had a recommendation of having separate Application Insights resources for iOS and Android.
  • I don't understand the recommendation -- when I look at for example retention I do want to see the combined retention of iOS and Android, but I also want to be able to split it by platform in the visualisations when needed.
  • What is the reason it's saying this shouldn't be done when it's a very common use case?
  • Is the reason that the visualisations can't be segmented based on platform if they are dumped into the same resource? Or something else?
  1. I would like to see app errors under the "Failures" section in Application Insights. The documentation says "By default, a new export configuration exports Analytics data only (events, sessions, and so on) Diagnostics-related data can be exported by setting Entities property".
  • Does this refer to blob export only or Application Insights as well?
  • If it's blob only, how do I enable it for Application Insights? The entire point behind what I'm doing is to get a uniform visualisation of server and client errors in one dashboard.
  • Also, what is the "Entities" property that should be set -- the only export option is the instrumentation key.

All of this kind of info is completely left out.


Document Details

Do not edit this section. It is required for docs.microsoft.com ➟ GitHub issue linking.

Tommigun1980 avatar Sep 13 '20 18:09 Tommigun1980

Still no answer to all those questions? Awesome.

alexmartinezm avatar Mar 31 '22 10:03 alexmartinezm