How to open and analyze Citrix CDF traces (CDFLogFile.etl files)

Your ads will be inserted here by

Easy Plugin for AdSense.

Please go to the plugin admin page to
Paste your ad code OR
Suppress this ad slot.

Many Citrix administrators are complaining, that it’s very hard to debug errors in Citrix products. Some times you can switch logging (for example in XenDesktop DDC or VDA). Another time you can find some information in Windows event log. But what about deep debugging. For that purpose Citrix released (in 2007) special tool – CDFControl [CTX111961]. It’s not a problem to collect logs. But how to open them after that? There is a tool – CDFAnalyzer [CTX122741]. So, let’s start:

Load CDFLogFile.etl (generated by CDFControl) into CDFAnalyzer:

cdf_5

In the message column we’ve got some strange strings:

<Unknown Format>: Failed to find matching TMF for GUID -> 44900D50-89DC-EA2A-D316-8B9DE115CC33
<Unknown Format>: Failed to find matching TMF for GUID -> 7ED04F11-96C7-7125-B707-8A8418A49443
<Unknown Format>: Failed to find matching TMF for GUID -> 44900D50-89DC-EA2A-D316-8B9DE115CC33
<Unknown Format>: Failed to find matching TMF for GUID -> D8035FDF-CFE7-356E-7638-DF18A86DAFCF
<Unknown Format>: Failed to find matching TMF for GUID -> 44900D50-89DC-EA2A-D316-8B9DE115CC33
<Unknown Format>: Failed to find matching TMF for GUID -> 7ED04F11-96C7-7125-B707-8A8418A49443
<Unknown Format>: Failed to find matching TMF for GUID -> 44900D50-89DC-EA2A-D316-8B9DE115CC33
<Unknown Format>: Failed to find matching TMF for GUID -> D8035FDF-CFE7-356E-7638-DF18A86DAFCF
<Unknown Format>: Failed to find matching TMF for GUID -> 44900D50-89DC-EA2A-D316-8B9DE115CC33

That means, the we didn’t have “symbols” to solve that GUID strings. For downloading that files we will use another Citrix tool – CDFMonitor [CTX129537]. Start the command line, go to CDFMonitor directory and type:

CDFMonitor.exe /downloadtmfs

cdf_1

CDFMonitor will ask you for your credentials for citrix.com. I was able to download symbols with and without my username (just clicking “Cancel“):

cdf_2

Your ads will be inserted here by

Easy Plugin for AdSense.

Please go to the plugin admin page to
Paste your ad code OR
Suppress this ad slot.

After that you will see how many TMF files will be downloaded (20963 in that case):

cdf_3

In my case (I have pretty good Internet connection) it tooks about 2 hours to download them all (210MB)

cdf_6

Now, when we have all the TMF files we can configure CDFAnalyzer to use them. From menu choose “Tools” and the “Properties” and put the whole path where TMF files are located.

cdf_4

At the end, load again out traces – CDFLogFile.etl. Voilà :-)

CDF_INFO 4 Received login port request from device at X.X.X.X:6901.
CDF_INFO 8 Send: LS_PORT_REPLY (login) to device at X.X.X.X:6901 with primary connection at A676014
CDF_INFO 4 Recv: LS_LOGIN_REQUEST_V2 from device at X.X.X.X:6901 [0000000000], RimsId = 00000000:00000000
CDF_INFO 4 CreateNewContext for IP:A67601F, Type 3
CDF_INFO 8 handing out connection = 0
CDF_INFO 8 DoGetDevice got device record, name = TERMSRV, mac = 00155DDD8215
CDF_INFO 4 DeviceGetByMac succeeded for device X.X.X.X:6901 [00155DDD8215]
CDF_INFO 4 device deviceName = <TERMSRV>, mac = <0000000000>, deviceType = 2
CDF_INFO 4 deviceIntId = 2, deviceType = 2
CDF_INFO 8 handing out connection = 0
CDF_ENTRY 9 Entry, Ardence::CDiskLocatorDbAccess::DoGetByDeviceIdAndType
CDF_INFO 4 About to get disklocators for a maintenance device
CDF_INFO 4 found resultset #1
CDF_INFO 8 harvested baseDiskLocatorIntId = 1, diskVersion = 0, diskLocatorName = <XA_test>
CDF_INFO 8 returning base disk id = 1, version number = 0, diskFileName = <XA_test.vhd>
CDF_INFO 8 access is: 0, writeCacheType = 0
CDF_INFO 4 found record 1/1, diskId = base disk id = 1, version number = 0, recordType = <privateDiskVersion>
CDF_INFO 4 added version to list: base disk id = 1, version number = 0, diskFileName = <XA_test.vhd>, access = 0)
CDF_INFO 4 private = true, pending = false
CDF_INFO 4 found resultset #2
CDF_INFO 4 found resultset #3

cdf_7

Note: Periodically refresh all your TMF files from citrix website. Today I’ve downloaded 20963 files. Previous time (2 weeks ago) I got “only” 20760 files. So there are 203 more symbols. And before downloading new files remember to backup the old ones (just in case).

Post author

There are 15 Comments

  1. Posted by Dieter Reply

    Thanks a bunch, will try this!
    Downloading files right now 😉

  2. Posted by Israel Lugo Reply

    Thx a lot
    Simply, clear
    Preciso (Spanish)

  3. Posted by jarek Reply

    I’m really happy, that I have helped. Here is my second post how to analyze traces in CDFControl tool – http://xenthusiast.com/analyzing-cdflogfile-etl-in-cdfcontrol/

  4. Posted by Martin Reply

    Unfortunately, the last few weeks it is impossible to download the TMFS files from Citrix and I am experiencing the same problem that you described in another article about reboot behaviour. Servers are not rebooting, regardless if I am using GPO’s or Citrix policies. Registry is set, no problems there, rebooted, but nothing happens. No events in the eventvwr. So, if you have TMFS files somewhere for download or wetransfer.com, that would be very helpfull to me.

    • Posted by jarek Reply

      Hello Martin,
      sorry for late answer, but I was offline during vacation.
      I’ve just checked, if I can download TMFS files, and everything works OK. Maybe there was a problem on Citrix site.
      When I finish downloading symbols I will upload it to my dropbox and post here link if you still have a problem.

      P.S.
      do you still have a problem with server reboot?

      • Posted by Martin Reply

        Hello,

        I did try a week ago but no download available. I haven’t checked this week, so I will try on monday, since it is weekend here already 😉

        Reboot still not working, no errors anywhere….

        • Posted by jarek Reply

          Here are brand new TMFS files from Citrix – http://xenthusiast.com/tmfs-files-citrix-cdfcontrol-symbols-2014-09-26/ (if you still have problem with downloading it).
          And about that reboot. Please collect CDFTraces (as it was described here: http://xenthusiast.com/citrix-xenapp-server-reboot-problem-debugging/) and send it to me (using dropbox, etc.). I will try to look at it.

          • Posted by Martin

            The server is available again, so I downloaded the TMF files from there. So now I can check what the error is, thanks to your excellent post on this subject. In fact, it is the only post that I found on Citrix Xenapp 6.5 reboot problem.

            The error is: License not available. Reboot will be skipped…

  5. Posted by kai Reply

    hi jarek, nice article really!!! ive an issue if i wanna to download via CLI -> “CDFMonitor.exe /downloadtmfs”

    the Message is: “Fail:guid and regex have to be supplied. exiting”

    do you have an idea, what does it means?

    Greetings Kai

    • Posted by jarek Reply

      Hello kai,
      like I wrote on the post above, I was on vacation and I couldn’t even verify it this works or not.
      Today everything is working. Do you still have this problem with downloading symbols?

  6. Posted by Jagadeesh Ananthaiah Reply

    Thanks for the good guidelines Jarek. i too encountered the error “Failed:guid and regex have to be supplied. exiting” when downloading TMF’s.

    the solution to this i figured out is to open the CDFMonitor.exe.config & change the value of the following lines to “All” & save the file.

    i was then able to download the TMF’s. I was also not prompted to login to the citrix site.

    hope it helps others !!

  7. Posted by Jagadeesh Ananthaiah Reply

    add key=”modules” value=”All”
    add key=”regex” value= “All”

  8. Posted by Tim Reply

    I downloaded the tmfs files (21,104 of them) and pointed CdfAnalyzer to the tmfs folder, but still get Failed to find matching TMF for GUID. What else do I need to do to see the etl file?

    • Posted by jarek Reply

      Hello Tim,

      AFAIK Citrix does not published all symbols. They still has got a part of private symbols for internal usage only. SO the only one way to analyze those traces is to send it to Citrix support (if you have one).
      P.S. Microsoft (and other vendors do the same).

  9. Posted by Viktor Filipov Reply

    Hello,

    The article is indeed very well described. I have tried this but unfortunately ran into some issue.
    I ran the CDFtrace, then opened the trace log in CDF Analyzer , and then ran CDFMonitor.exe /downloadtmfs in the CDFMonitor directory.
    The thing is that after the command ends it just finds only one tmf count: 1. Well, in the CDFAnalyzer canbe seen around 430 000 entries.
    Is there anything wrong I have been doing?
    Thank you in advance!

Leave a Reply