From 51ef6112bd1afc0c169ffb0cb6559781244af268 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Jan=20=C4=8Cerm=C3=A1k?= <sairon@users.noreply.github.com>
Date: Mon, 22 Sep 2025 14:50:10 +0200
Subject: [PATCH] Add documentation for profiler.dump_sockets service (#40897)

Co-authored-by: Stefan Agner <stefan@agner.ch>
Co-authored-by: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
---
 source/_integrations/profiler.markdown | 20 ++++++++++++++++++++
 1 file changed, 20 insertions(+)

diff --git a/source/_integrations/profiler.markdown b/source/_integrations/profiler.markdown
index ac135ef0bd9..b4a4760982c 100644
--- a/source/_integrations/profiler.markdown
+++ b/source/_integrations/profiler.markdown
@@ -213,3 +213,23 @@ An example is below:
 ```txt
 [homeassistant.components.profiler] Task: <Task pending name='Task-1133' coro=<HubConnector._listener() running at /usr/local/lib/python3.12/site-packages/aioharmony/hubconnector_websocket.py:362> wait_for=<Future pending cb=[Task.task_wakeup()]>>
 ```
+
+### Action profiler.dump_sockets
+
+{% my developer_call_service badge service="profiler.dump_sockets" %}
+
+Log all sockets used by Home Assistant. This action can help identify what network connections are currently open, mainly to help track down connections that are not being closed properly.
+
+Example output:
+
+```txt
+[homeassistant.components.profiler] Sockets used by Home Assistant:
+<socket.socket [closed] fd=-1, family=2, type=1, proto=6>
+<socket.socket fd=97, family=2, type=1, proto=6, laddr=('192.168.1.10', 80), raddr=('192.168.1.14', 59086)>
+<socket.socket fd=7, family=1, type=1, proto=0>
+<socket.socket fd=8, family=1, type=1, proto=0>
+<socket.socket fd=11, family=10, type=1, proto=6, laddr=('::', 80, 0, 0)>
+<socket.socket fd=12, family=2, type=1, proto=6, laddr=('0.0.0.0', 80)>
+<socket.socket fd=15, family=10, type=2, proto=0, laddr=('::', 5353, 0, 0)>
+...
+```