minidump.tsx 2.8 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081
  1. import {Fragment} from 'react';
  2. import ExternalLink from 'sentry/components/links/externalLink';
  3. import List from 'sentry/components/list';
  4. import ListItem from 'sentry/components/list/listItem';
  5. import type {
  6. Docs,
  7. DocsParams,
  8. OnboardingConfig,
  9. } from 'sentry/components/onboarding/gettingStartedDoc/types';
  10. import {CrashReportWebApiOnboarding} from 'sentry/components/onboarding/gettingStartedDoc/utils/feedbackOnboarding';
  11. import {t, tct} from 'sentry/locale';
  12. type Params = DocsParams;
  13. const getCurlSnippet = (params: Params) => `
  14. curl -X POST \
  15. '${params.dsn.public}' \
  16. -F upload_file_minidump=@mini.dmp`;
  17. const onboarding: OnboardingConfig = {
  18. install: params => [
  19. {
  20. title: t('Creating and Uploading Minidumps'),
  21. description: (
  22. <Fragment>
  23. {t(
  24. 'Depending on your operating system and programming language, there are various alternatives to create minidumps and upload them to Sentry. See the following resources for libraries that support generating minidump crash reports:'
  25. )}
  26. <List symbol="bullet">
  27. <ListItem>
  28. <ExternalLink href="https://docs.sentry.io/platforms/native/">
  29. Native SDK
  30. </ExternalLink>
  31. </ListItem>
  32. <ListItem>
  33. <ExternalLink href="https://docs.sentry.io/platforms/native/guides/breakpad/">
  34. Google Breakpad
  35. </ExternalLink>
  36. </ListItem>
  37. <ListItem>
  38. <ExternalLink href="https://docs.sentry.io/platforms/native/guides/crashpad/">
  39. Google Crashpad
  40. </ExternalLink>
  41. </ListItem>
  42. </List>
  43. </Fragment>
  44. ),
  45. configurations: [
  46. {
  47. description: tct(
  48. 'If you have already integrated a library that generates minidumps and would just like to upload them to Sentry, you need to configure the [italic:Minidump Endpoint URL], which can be found at [italic:Project Settings > Client Keys (DSN)]. This endpoint expects a [code:POST] request with the minidump in the [code:upload_file_minidump] field:',
  49. {
  50. code: <code />,
  51. italic: <i />,
  52. }
  53. ),
  54. language: 'bash',
  55. code: getCurlSnippet(params),
  56. },
  57. ],
  58. additionalInfo: tct(
  59. 'To send additional information, add more form fields to this request. For a full description of fields accepted by Sentry, see [passingAdditionalDataLink:Passing Additional Data].',
  60. {
  61. passingAdditionalDataLink: (
  62. <ExternalLink href="https://docs.sentry.io/platforms/native/guides/minidumps/" />
  63. ),
  64. }
  65. ),
  66. },
  67. ],
  68. configure: () => [],
  69. verify: () => [],
  70. };
  71. const docs: Docs = {
  72. onboarding,
  73. crashReportOnboarding: CrashReportWebApiOnboarding,
  74. };
  75. export default docs;