fix(examples): appease SonarCloud in WebSocket examples

Adds botocore timeouts to Management API clients, moves client
construction out of the handler, and enables function and access
logging in the getting-started SAM template. Example code, it turns
out, is held to production standards — fair enough.

Author: Iamrodos

docs/core/event_handler/api_gateway_websocket.md

@@ -65,7 +65,7 @@ You need an API Gateway WebSocket API with its routes integrated with your Lambd
 
 === "getting_started_with_websocket_api.yaml"
 
-    ```yaml hl_lines="27 50-80"
+    ```yaml hl_lines="39 62-92"
     --8<-- "examples/event_handler_api_gateway_websocket/sam/getting_started_with_websocket_api.yaml"
     ```
 
@@ -243,7 +243,7 @@ A stale connection ID raises `GoneException` — the client is no longer connect
 
 === "working_with_post_to_connection.py"
 
-    ```python hl_lines="2 16 28 35 41"
+    ```python hl_lines="2 18 30 37 44"
     --8<-- "examples/event_handler_api_gateway_websocket/src/working_with_post_to_connection.py"
     ```
 
@@ -254,7 +254,7 @@ A stale connection ID raises `GoneException` — the client is no longer connect
 
 === "working_with_post_to_connection_report_ready.py"
 
-    ```python hl_lines="18 23"
+    ```python hl_lines="24 29"
     --8<-- "examples/event_handler_api_gateway_websocket/src/working_with_post_to_connection_report_ready.py"
     ```
 

examples/event_handler_api_gateway_websocket/sam/getting_started_with_websocket_api.yaml

@@ -18,6 +18,18 @@ Resources:
     Properties:
       Handler: app.lambda_handler
       CodeUri: websocket_handler
+      LoggingConfig:
+        LogGroup: !Ref WebSocketHandlerLogs
+
+  WebSocketHandlerLogs:
+    Type: AWS::Logs::LogGroup
+    Properties:
+      RetentionInDays: 7
+
+  WebSocketAccessLogs:
+    Type: AWS::Logs::LogGroup
+    Properties:
+      RetentionInDays: 7
 
   WebSocketApi:
     Type: AWS::ApiGatewayV2::Api
@@ -85,6 +97,9 @@ Resources:
       ApiId: !Ref WebSocketApi
       StageName: prod
       AutoDeploy: true
+      AccessLogSettings:
+        DestinationArn: !GetAtt WebSocketAccessLogs.Arn
+        Format: '{"requestId":"$context.requestId","routeKey":"$context.routeKey","status":"$context.status","connectionId":"$context.connectionId"}'
 
   WebSocketInvokePermission:
     Type: AWS::Lambda::Permission

examples/event_handler_api_gateway_websocket/src/working_with_post_to_connection.py

@@ -1,9 +1,11 @@
 import boto3
 import my_connection_store  # (1)!
+from botocore.config import Config
 
 from aws_lambda_powertools.event_handler import APIGatewayWebSocketResolver
 from aws_lambda_powertools.utilities.typing import LambdaContext
 
+boto_config = Config(connect_timeout=3, read_timeout=5, retries={"total_max_attempts": 2})
 app = APIGatewayWebSocketResolver()
 
 
@@ -33,6 +35,7 @@ def broadcast():
     client = boto3.client(
         "apigatewaymanagementapi",
         endpoint_url=app.current_event.request_context.callback_url,  # (4)!
+        config=boto_config,
     )
     message: str = app.current_event.json_body["message"]
     for connection_id in my_connection_store.all_connection_ids():

examples/event_handler_api_gateway_websocket/src/working_with_post_to_connection_report_ready.py

@@ -6,18 +6,24 @@
 
 import boto3
 import my_connection_store
+from botocore.config import Config
 
 from aws_lambda_powertools import Logger
 from aws_lambda_powertools.utilities.typing import LambdaContext
 
 logger = Logger()
+boto_config = Config(connect_timeout=3, read_timeout=5, retries={"total_max_attempts": 2})
+
+
+def management_client_for(callback_url: str):
+    return boto3.client("apigatewaymanagementapi", endpoint_url=callback_url, config=boto_config)
 
 
 def lambda_handler(event: dict, context: LambdaContext) -> None:
     connection_id = event["connectionId"]
     callback_url = my_connection_store.get_callback_url(connection_id)  # (1)!
 
-    client = boto3.client("apigatewaymanagementapi", endpoint_url=callback_url)
+    client = management_client_for(callback_url)
     try:
         client.post_to_connection(ConnectionId=connection_id, Data=json.dumps(event["report"]).encode())
     except client.exceptions.GoneException:  # (2)!