Sie können jederzeit manuell eine AlloyDB Omni-Dumpdatei generieren. Die Untersuchung der Dump-Datei hilft Ihnen oder dem Google Cloud Kundenservice, Probleme mit Ihrer AlloyDB Omni-Installation zu analysieren, z. B. Deadlocks, die neue Verbindungen blockieren, langsame Abfragen, langsame VACUUM-Vorgänge oder eine hohe Nutzung von Arbeitsspeicher, CPU oder Speicher.
Führen Sie den folgenden Befehl aus, um eine Dumpdatei zu generieren:
INSTALL_PATH: Der Pfad zu Ihrem AlloyDB Omni-Installationsverzeichnis, auf das vom Hostdateisystem aus zugegriffen werden kann.
USERNAME: Der Name des Nutzers, der eine Verbindung zur Datenbank herstellt.
PORT: Der TCP-Port, über den AlloyDB Omni Verbindungen akzeptiert.
Der Standardwert ist 5432.
HOSTNAME: Der Hostname des Computers, auf dem AlloyDB Omni ausgeführt wird.
Wenn der Wert mit einem Schrägstrich beginnt, wird er als Verzeichnis für einen Unix-Domain-Socket verwendet.
Der Standardwert ist localhost.
CONTAINER_NAME: der Name des Containers, in dem AlloyDB Omni ausgeführt wird.
In der Befehlsausgabe wird der Speicherort der System-Dumpdatei angezeigt.
Weitere Informationen zu den Befehlsargumenten erhalten Sie mit folgendem Befehl:
/tmp/alloydb-sysdump--help
AlloyDB Omni-Dumpdatei prüfen
Eine AlloyDB Omni-Dumpdatei ist eine normale Textdatei, in der verschiedene Aspekte des Systemstatus zusammengefasst werden. Öffnen Sie die Datei in einem Texteditor, im Programm less oder in einem anderen Programm zum Anzeigen von Textdateien.
AlloyDB Omni speichert die Datei in Ihrem Datenverzeichnis und benennt sie als alloydb_system_dump_ gefolgt von einem Zeitstempel. Beispiel: alloydb_system_dump_20240614_062953PM
Supportanfrage erstellen, um Unterstützung zu erhalten
Wenn Sie Hilfe bei der Interpretation einer Systemdumpdatei zur Fehlerbehebung bei AlloyDB Omni benötigen, erstellen Sie einen Supportfall und hängen Sie die Datei an. Sie benötigen ein Google Cloud -Konto, um eine Supportanfrage zu erstellen.
Das AlloyDB-Team bearbeitet die Anfrage entsprechend ihrer Priorität und des jeweiligen Supportangebots zum Zeitpunkt der Fallerstellung.
[[["Leicht verständlich","easyToUnderstand","thumb-up"],["Mein Problem wurde gelöst","solvedMyProblem","thumb-up"],["Sonstiges","otherUp","thumb-up"]],[["Schwer verständlich","hardToUnderstand","thumb-down"],["Informationen oder Beispielcode falsch","incorrectInformationOrSampleCode","thumb-down"],["Benötigte Informationen/Beispiele nicht gefunden","missingTheInformationSamplesINeed","thumb-down"],["Problem mit der Übersetzung","translationIssue","thumb-down"],["Sonstiges","otherDown","thumb-down"]],["Zuletzt aktualisiert: 2025-09-04 (UTC)."],[[["\u003cp\u003eThis guide details how to generate system dump files for AlloyDB Omni, which are essential for analyzing and troubleshooting unexpected issues.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003ealloydb-sysdump\u003c/code\u003e utility, extracted from the AlloyDB Omni Docker image, is used to create these dump files.\u003c/p\u003e\n"],["\u003cp\u003eTo generate a dump file, you need to use a specific command with details such as the installation path, username, port, hostname, and container name.\u003c/p\u003e\n"],["\u003cp\u003eDump files are stored in your data directory, and they are text files that summarize the system's state at the time they were created, identifiable by a timestamp in their name.\u003c/p\u003e\n"],["\u003cp\u003eIf you need help interpreting a dump file, you can create a support case and attach it, ensuring you have a Google Cloud account.\u003c/p\u003e\n"]]],[],null,["# Generate and diagnose AlloyDB Omni dump files\n\nSelect a documentation version: Current (16.8.0)keyboard_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\nExtract the `alloydb-sysdump` utility that is included in the AlloyDB Omni Docker image you [installed](/alloydb/omni/current/docs/install): \n\n### Docker\n\n docker run --rm --entrypoint /bin/bash $IMAGE -c \"cat /usr/lib/postgresql/15/bin/alloydb-sysdump\" \u003e /tmp/alloydb-sysdump\n chmod +x /tmp/alloydb-sysdump\n\n### Podman\n\n podman run --rm --entrypoint /bin/bash $IMAGE -c \"cat /usr/lib/postgresql/15/bin/alloydb-sysdump\" \u003e /tmp/alloydb-sysdump\n chmod +x /tmp/alloydb-sysdump\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 sudo /tmp/alloydb-sysdump -D=\u003cvar translate=\"no\"\u003eINSTALL_PATH\u003c/var\u003e -U=\u003cvar translate=\"no\"\u003eUSERNAME\u003c/var\u003e -p=\u003cvar translate=\"no\"\u003ePORT\u003c/var\u003e -H=\u003cvar translate=\"no\"\u003eHOSTNAME\u003c/var\u003e -c=\u003cvar translate=\"no\"\u003eCONTAINER_NAME\u003c/var\u003e\n\nReplace the following:\n\n- \u003cvar translate=\"no\"\u003eINSTALL_PATH\u003c/var\u003e: the path to your AlloyDB Omni installation directory accessible from the host file system.\n- \u003cvar translate=\"no\"\u003eUSERNAME\u003c/var\u003e: the name of the user connecting to the database.\n- \u003cvar translate=\"no\"\u003ePORT\u003c/var\u003e: the TCP port where AlloyDB Omni accepts connections on. The default value is `5432`.\n- \u003cvar translate=\"no\"\u003eHOSTNAME\u003c/var\u003e: the hostname of the machine on which AlloyDB Omni runs. If the value begins with a slash, it is used as the directory for a Unix domain socket. The default value is `localhost`.\n- \u003cvar translate=\"no\"\u003eCONTAINER_NAME\u003c/var\u003e: the name of the container in which AlloyDB Omni runs.\n\n The command output displays the location of the system dump file.\n\n To learn more about the command arguments, run: \n\n /tmp/alloydb-sysdump --help\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_20240614_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](/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."]]
