Getting Log Files from Telegram

Voice & Video Call Issues

If possible, please also ask your chat partner to send you the log file for their part of the call, it will help us a lot to have the logs from both sides.

Step 1: Take the same device which you used to make the call. (You need logs which only exist on that device.)

Step 2: Find the call in your chat history. Then:

Android: Tap next to the Call message in the chat > Rate Call > Rate 1 Star and select "Include technical information" > tap Send. This will send a log file to a chat called "VOIP Support", you can also forward this file elsewhere.

iOS: Tap and hold the Call message > Share Statistics.

macOS: Right-click the Call message > Share Call Logs.

Telegram Desktop:

1. Open Telegram Settings and type debugmode while viewing the Settings page. This will offer to enable debug logs and relaunch the app.

2. Reproduce the problem.

3. Open the app folder > DebugLogs subfolder > send us the "last_call_log.txt" file.

4. Open Telegram Settings and type debugmode. This will offer to disable debug logs and relaunch the app. We also recommend to clean the DebugLogs folder since it may contain sensitive data.

General Issues

Android

NOTE: We will only need app logs for certain specific issues, there's no need for you to collect them unless we specifically asked for it.

1. Go to Telegram Settings, scroll down to the end, long-tap twice on the build number and version. This will open the debug menu.

2. Select Enable logs.

3. Relaunch the app (by terminating it from processes list and launching again).

4. Reproduce the problem (note at what time the issue happened).

5. Go to Telegram Settings > Debug > Send Logs > send the logs to us, don't forget to tell us the exact time at which the issue happened.

6. Open the debug menu again (see Step 1) and disable logging.

iOS

NOTE: We will only need app logs for certain specific issues, there's no need for you to collect them unless we specifically asked for it.

1. Tap 10 times on the Settings icon. The debug menu will open.

2. Enable Log to File.

3. Relaunch the app (double tap home button, swipe up on Telegram, then launch the app again).

4. Reproduce the problem (note at what time the issue happened).

5. Open the debug menu (see Step 1) > Send Latest Log > send the logs to us, don't forget to tell us the exact time at which the issue happened.

6. Go back to the debug menu and disable the logs.

Telegram Desktop

NOTE: We will only need app logs for certain specific issues, there's no need for you to collect them unless we specifically asked for it.

1. Reproduce the problem (note at what time the issue happened).

2. Open Telegram Settings and type viewlogs when viewing the Settings page. This will open the folder which contains a log.txt file.

3. Send the file to us, don't forget to tell us the exact time at which the issue happened.

Telegram macOS (native app)

NOTE: We will only need app logs for certain specific issues, there's no need for you to collect them unless we specifically asked for it.

1. Quickly click on the Settings icon 5 times. This will open the debug menu.

2. Select Enable logs.

3. Reproduce the problem (note at what time the issue happened).

4. Go back to the debug menu (see Step 1), select Open logs, the Logs folder will open.

5. Choose the file named with the time period of the issue. Send it to us, don't forget to tell us the exact time at which the issue happened.

Rare Issues

Telegram Desktop, debug logs

Sometimes the basic logs are not enough and we may tell you we need more detailed information from your app. Please only collect these logs if we specifically asked for them during a troubleshooting session.

1. Open Telegram Settings and type debugmode when viewing the Settings page. This will suggest to enable debug logs and relaunch the app.

2. Reproduce the problem (note at what time the issue happened).

3. Open Telegram Settings and type viewlogs. This will open the app folder with a new DebugLogs subfolder. It will contain files with three prefixes: log_, tcp_ and mtp_ -- the devs usually need files with a particular prefix depending on the issue.

The files with the mtp_ prefix will contain the messages you sent and received while logs were enabled. The devs may only ask for those when troubleshooting issues with messages. Make sure other people can't access these files and clean them after you disable logging.

4. Send us the files with the necessary prefix and write the exact time when the issue happened.

5. Open Telegram Settings and type debugmode. This will suggest to disable debug logs and relaunch the app.

Android, connection issues

We don't usually need app logs to solve connection issues, so please only collect these logs if we specifically asked for them during a troubleshooting session.

1. Install the beta version.

2. Go to Telegram Settings, scroll down to the end, long-tap twice on the build number and version. This will open the debug menu.

2. Select Enable logs.

3. Relaunch the app (by terminating it from processes list and launching again).

4. Reproduce the problem (note at what time the issue happened).

5. Go to Telegram Settings > Send Logs > send the logs to us, don't forget to tell us the time when the issue happened.

6. Open the debug menu again (see Step 2) and disable logging.

iOS, issues when logging in

We don't usually need app logs to solve login issues, so please only collect these logs if we specifically asked for them during a troubleshooting session.

1. On the login screen, tap 10 times on "Your Phone". This will open the debug menu.

2. Enable Log to File.

3. Relaunch the app (double tap home button, swipe up on Telegram, then launch the app again).

4. Reproduce the problem.

5. Open the debug menu (see Step 1) > Send Latest Log > send it to us.

6. Go back to the debug menu and disable logging.

iOS, stuck on "Optimizing"

1. Wait for 2-3 minutes.

2. Long tap in the top left corner of the screen, this will open the Sharing menu which will let you send us the logs.

Telegram Desktop, audio logs (Windows)

Audio logs are NOT meant for voice & video call issues. This is for difficult issues with audio playback. Please only collect these logs if we specifically asked for them during a troubleshooting session.

1. Open the Command Prompt (Win+R, type "cmd", Enter)

2. Go to the folder where Telegram.exe is located.

To open a folder there, type cd folder_name and hit Enter. To change the drive to, for example, "D:\" type D: and hit Enter.

3. Type SET ALSOFT_LOGLEVEL=4 and hit Enter

4. Type Telegram.exe 2> audio_log.txt and hit Enter. Telegram Desktop will open.

5. Reproduce the problem (note at what time the issue happened)

6. Quit the app (right-click on the tray icon -> Quit Telegram)

7. Collect the "audio_log.txt" file, it should be available next to Telegram.exe. Send the file to us and write the exact time when the issue happened.

Telegram Desktop, audio logs (Mac)

Audio logs are NOT meant for voice & video call issues. This is for difficult issues with audio playback. Please only collect these logs if we specifically asked for them during a troubleshooting session.

1. Open Terminal, go to Home folder

2. Type "ALSOFT_LOGLEVEL=4 /Applications/Telegram.app/Contents/MacOS/Telegram 2> audio_log.txt", hit Enter.

3. Reproduce the problem (note at what time the issue happened).

4. Quit the app (right-click on the app icon -> Quit).

5. Send the audio_log.txt file to us and write the exact time when the issue happened.

Telegram Desktop, audio logs (Linux)

Audio logs are NOT meant for voice & video call issues. This is for difficult issues with audio playback. Please only collect these logs if we specifically asked for them during a troubleshooting session.

1. Open Terminal, go to Home folder.

2. Type "ALSOFT_LOGLEVEL=4 path/to/Telegram 2> audio_log.txt", hit Enter.

3. Reproduce the problem (note at what time the issue happened).

4. Quit the app.

5. Send the audio_log.txt file to us and write the exact time when the issue happened.

Android X

1. Go to Settings and tap on the version number. The debug menu will open.

2. Choose Application Logs > enable Use logcat.

3. Reproduce the issue (note at what time the issue happened).

4. Send us the latest log available under Application logs > Log files. Write the exact time when the issue happened.

Android X, TDLib logs

1. Go to Settings and tap on version number. The debug menu will open.

3. Choose TDLib Logs.

4. Clear TDLib_log.txt.

5. Reproduce the issue (note at what time the issue happened).

6. Open the debug menu again (see Step 1), share TDlib_log.txt availble under TDLib logs.

Settings for Verbosity and Modules should differ depending on the issue. The dev will know which settings are necessary.