minidump.tsx 3.0 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485
  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 {Layout, LayoutProps} from 'sentry/components/onboarding/gettingStartedDoc/layout';
  6. import {ModuleProps} from 'sentry/components/onboarding/gettingStartedDoc/sdkDocumentation';
  7. import {t, tct} from 'sentry/locale';
  8. // Configuration Start
  9. export const steps = ({
  10. dsn,
  11. }: {
  12. dsn?: string;
  13. } = {}): LayoutProps['steps'] => [
  14. {
  15. title: t('Creating and Uploading Minidumps'),
  16. description: (
  17. <Fragment>
  18. {t(
  19. '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:'
  20. )}
  21. <List symbol="bullet">
  22. <ListItem>
  23. <ExternalLink href="https://docs.sentry.io/platforms/native/">
  24. Native SDK
  25. </ExternalLink>
  26. </ListItem>
  27. <ListItem>
  28. <ExternalLink href="https://docs.sentry.io/platforms/native/guides/breakpad/">
  29. Google Breakpad
  30. </ExternalLink>
  31. </ListItem>
  32. <ListItem>
  33. <ExternalLink href="https://docs.sentry.io/platforms/native/guides/crashpad/">
  34. Google Crashpad
  35. </ExternalLink>
  36. </ListItem>
  37. </List>
  38. </Fragment>
  39. ),
  40. configurations: [
  41. {
  42. description: (
  43. <p>
  44. {tct(
  45. 'If you have already integrated a library that generates minidumps and would just like to upload them to Sentry, you need to configure the [minidumpEndpointUrlItalic:Minidump Endpoint URL], which can be found at [projectSettingsItalic:Project Settings > Client Keys (DSN)]. This endpoint expects a [postCode:POST] request with the minidump in the [uploadFileMinidumpCode:upload_file_minidump] field:',
  46. {
  47. postCode: <code />,
  48. uploadFileMinidumpCode: <code />,
  49. minidumpEndpointUrlItalic: <i />,
  50. projectSettingsItalic: <i />,
  51. }
  52. )}
  53. </p>
  54. ),
  55. language: 'bash',
  56. code: `
  57. curl -X POST \
  58. '${dsn}' \
  59. -F upload_file_minidump=@mini.dmp
  60. `,
  61. },
  62. ],
  63. additionalInfo: (
  64. <p>
  65. {tct(
  66. '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].',
  67. {
  68. passingAdditionalDataLink: (
  69. <ExternalLink href="https://docs.sentry.io/platforms/native/guides/minidumps/" />
  70. ),
  71. }
  72. )}
  73. </p>
  74. ),
  75. },
  76. ];
  77. // Configuration End
  78. export function GettingStartedWithMinidump({dsn, ...props}: ModuleProps) {
  79. return <Layout steps={steps({dsn})} {...props} />;
  80. }
  81. export default GettingStartedWithMinidump;