无需Application Insights查看Java版Azure Function日志及写入文件方法

可以不使用Application Insights查看Azure Function App日志，同时也能将日志写入独立文件，针对Java语言的具体操作步骤如下：

一、启用文件系统日志持久化 #

• 登录Azure门户，定位到你的Function App，进入配置 > 应用程序设置
• 添加以下关键应用设置：
  • WEBSITE_CONTENTAZUREFILECONNECTIONSTRING：填入你的存储账户连接字符串（用于持久化存储日志文件）
  • WEBSITE_CONTENTSHARE：设置一个唯一的文件共享名称（例如func-java-logs）
  • 确认FUNCTIONS_WORKER_RUNTIME的值为java
• 保存设置后重启Function App

二、配置Java日志框架（以Logback为例） #

Java函数常用Logback或Log4j2作为日志框架，以下是Logback的配置示例：

• 在项目src/main/resources目录下创建logback.xml文件
• 配置文件追加器，将日志写入Function App的持久化目录，示例代码：

<configuration>
    <!-- 文件追加器：写入持久化目录，重启不丢失 -->
    <appender name="FILE" class="ch.qos.logback.core.FileAppender">
        <file>/home/site/wwwroot/logs/func-execution.log</file>
        <encoder>
            <pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n</pattern>
        </encoder>
    </appender>

    <!-- 控制台追加器：保留门户控制台输出能力 -->
    <appender name="CONSOLE" class="ch.qos.logback.core.ConsoleAppender">
        <encoder>
            <pattern>%d{HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n</pattern>
        </encoder>
    </appender>

    <root level="INFO">
        <appender-ref ref="FILE" />
        <appender-ref ref="CONSOLE" />
    </root>
</configuration>

• 若使用Log4j2，只需对应配置FileAppender，指定文件路径为/home/site/wwwroot/logs/func-execution.log即可

三、查看日志文件 #

• Kudu工具查看：进入Function App的开发工具 > 高级工具，点击Go打开Kudu界面；选择Debug console > CMD/PowerShell，导航到/home/site/wwwroot/logs目录，可直接查看、下载日志文件
• Azure CLI下载：执行命令 az webapp log download --name <你的Function App名称> --resource-group <资源组名称>，将日志包下载到本地查看
• 存储账户查看：日志文件会同步到你配置的存储账户文件共享中，直接在存储账户的文件服务模块中访问

注意事项 #

• 优先选择/home/site/wwwroot目录存储日志，该目录为持久化目录，重启Function App不会丢失数据；/tmp为临时目录，重启后会清空
• 配置日志滚动策略（如按文件大小、日期分割），避免单个日志文件过大
• 定期清理旧日志，防止占用过多存储空间

内容的提问来源于stack exchange，提问作者Kanyu