C# - (.NET Framework를 위한) Oracle.ManagedDataAccess 패키지의 성능 카운터 설정 방법
지난 글에서 .NET Core 버전의 Oracle.ManagedDataAccess에 대한 성능 카운터를 다뤘는데요,
C# - Oracle.ManagedDataAccess.Core의 성능 카운터 설정 방법
; https://www.sysnet.pe.kr/2/0/13000
이번에는 .NET Framework에서 실행되는 Oracle.ManagedDataAccess 패키지를 위한 성능 카운터 사용법을 설명해 보겠습니다.
사실, 전체적인 방법은 "
C# - Oracle.ManagedDataAccess.Core의 성능 카운터 설정 방법" 글에서 설명한 것과 같습니다.
단지, 차이점이라면 (Core 버전과는 달리) Oracle.ManagedDataAccess 패키지의 경우 OracleConfiguration 타입을 제공하지 않습니다. 대신 app.config에 OracleConfiguration.PerformanceCounters에서 설정하는 것과 유사한 설정을 제공하므로, 다음과 같은 식으로 대체할 수 있습니다.
<?xml version="1.0" encoding="utf-8"?>
<configuration>
...[생략]...
<oracle.manageddataaccess.client>
<version number="*">
<settings>
<setting name="PerformanceCounters" value="4095" />
</settings>
</version>
</oracle.manageddataaccess.client>
</configuration>
또한, Core 버전의 경우 System.Diagnostics.PerformanceCounter 타입을 사용할 수 있도록 별도의 패키지 참조를 필요로 했지만, .NET Framework 환경에서는 System.dll에 PerformanceCounter 타입을 포함하고 있으므로 그 과정 자체가 필요 없습니다.
그다음, 이것을 성능 모니터링 도구에서 확인을 해야 하는데요, 이를 위해 역시 powershell 스크립트를 실행해야 합니다.
[설치]
register_odpm_perfmon_counters.ps1
[제거]
unregister_odpm_perfmon_counters.ps1
마찬가지로 위의 스크립트 파일도 nuget 패키지에 포함돼 있지만, 패키지 버전이 18.3.0 (어셈블리 버전 4.122.18.3) 버전 이하에는 없습니다. 따라서 그 상위의 버전을 설치하면 아래의 경로에서,
// Oracle.ManagedDataAccess 버전이 19.3.0인 경우
[솔루션 디렉터리]\packages\Oracle.ManagedDataAccess.19.3.0\PerfCounters
register_odpm_perfmon_counters.ps1 파일을 찾을 수 있습니다. 설치 후, 성능 모니터링 도구를 보면 다음과 같이 "ODP.NET, Managed Driver"라는 범주를 볼 수 있고,
실행 중인 프로세스 중에 "성능 카운터를 활성화 + Oracle.ManagedDataAccess를 사용"한다면 위와 같이 "Instances of selected object"에 그 프로세스가 올라오게 됩니다.
참고로, 18.3.0 버전 이하에는 ps1 스크립트 파일만 nuget 패키지에 없는 것일 뿐 그냥 동일하게 상위 버전의 ps1 스크립트 파일을 실행해도 성능 카운터 연동에는 문제가 없습니다.
[이 글에 대해서 여러분들과 의견을 공유하고 싶습니다. 틀리거나 미흡한 부분 또는 의문 사항이 있으시면 언제든 댓글 남겨주십시오.]