You can manually generate an AlloyDB Omni dump file any time. Examining
the dump file helps you or Google Cloud Customer Care analyze issues with your AlloyDB Omni
installation, such as deadlocks that block new connections, slow queries, slow
vacuum, high usage of memory, CPU, or storage.
To generate a dump file, run the following command:
alloydbdatabase-serversystem-dump
The command output displays the location of the system dump file.
Review an AlloyDB Omni dump file
An AlloyDB Omni dump file is an ordinary text file that summarizes
various aspects of the system's state. To review it, open it in a text editor, the
less program, or any other program for viewing text files.
AlloyDB Omni saves the file in your data directory, and it names
the file as alloydb_system_dump_ followed by a timestamp. For example,
alloydb_system_dump_20230816_062953PM.
Create a support case for assistance
If you need assistance in interpreting a system dump file to troubleshoot a
problem with AlloyDB Omni, then create a support case and attach the file to it. You must have
a Google Cloud account to create a support case.
The AlloyDB team responds to the case based on its priority and
the respective support service at the time of creation.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-28 UTC."],[[["\u003cp\u003eThis page explains the process of generating and reviewing AlloyDB Omni system dump files for troubleshooting purposes.\u003c/p\u003e\n"],["\u003cp\u003eYou can manually generate a dump file using the \u003ccode\u003ealloydb database-server system-dump\u003c/code\u003e command, and its location will be provided in the command output.\u003c/p\u003e\n"],["\u003cp\u003eThe system dump file is a text file located in the data directory, named with a timestamp, which can be viewed using a text editor or similar tools.\u003c/p\u003e\n"],["\u003cp\u003eA generated system dump can help you or Google Cloud Customer Care to analyze issues with your AlloyDB Omni installation.\u003c/p\u003e\n"],["\u003cp\u003eIf you require assistance with interpreting the dump file, you can create a Google Cloud support case and attach the dump file to it.\u003c/p\u003e\n"]]],[],null,["# Generate and diagnose AlloyDB Omni dump files\n\nSelect a documentation version: 15.5.2keyboard_arrow_down\n\n- [Current (16.8.0)](/alloydb/omni/current/docs/manage-dump-files)\n- [16.8.0](/alloydb/omni/16.8.0/docs/manage-dump-files)\n- [16.3.0](/alloydb/omni/16.3.0/docs/manage-dump-files)\n- [15.12.0](/alloydb/omni/15.12.0/docs/manage-dump-files)\n- [15.7.1](/alloydb/omni/15.7.1/docs/manage-dump-files)\n- [15.7.0](/alloydb/omni/15.7.0/docs/manage-dump-files)\n- [15.5.5](/alloydb/omni/15.5.5/docs/manage-dump-files)\n- [15.5.4](/alloydb/omni/15.5.4/docs/manage-dump-files)\n- [15.5.2](/alloydb/omni/15.5.2/docs/manage-dump-files)\n\n\u003cbr /\u003e\n\nThis page describes how to generate AlloyDB Omni system dump files and analyze the causes of unexpected issues.\n\n\u003cbr /\u003e\n\nBefore you begin\n----------------\n\nEnsure that you have [installed the AlloyDB Omni CLI](/alloydb/omni/15.5.2/docs/omni-cli).\n\nGenerate an AlloyDB Omni dump file\n----------------------------------\n\nYou can manually generate an AlloyDB Omni dump file any time. Examining\nthe dump file helps you or Google Cloud Customer Care analyze issues with your AlloyDB Omni\ninstallation, such as deadlocks that block new connections, slow queries, slow\nvacuum, high usage of memory, CPU, or storage.\n\nTo generate a dump file, run the following command: \n\n alloydb database-server system-dump\n\nThe command output displays the location of the system dump file.\n\nReview an AlloyDB Omni dump file\n--------------------------------\n\nAn AlloyDB Omni dump file is an ordinary text file that summarizes\nvarious aspects of the system's state. To review it, open it in a text editor, the\n`less` program, or any other program for viewing text files.\n\nAlloyDB Omni saves the file in your data directory, and it names\nthe file as `alloydb_system_dump_` followed by a timestamp. For example,\n`alloydb_system_dump_20230816_062953PM`.\n\nCreate a support case for assistance\n------------------------------------\n\nIf you need assistance in interpreting a system dump file to troubleshoot a\nproblem with AlloyDB Omni, then [create a support case](https://cloud.google.com/support/docs/manage-cases#creating_cases) and attach the file to it. You must have\na Google Cloud account to create a support case.\n\nThe AlloyDB team responds to the case based on its priority and\nthe respective support service at the time of creation."]]
