Troubleshooting and FAQs

Troubleshooting and FAQs

This section lists most common errors, gives general tips, and explains system logs.

Viewing Logs

Log files are located in your Analytics installation folder.
  • On Linux or Mac OS X systems:

    cbas/samples/local/logs

  • On Windows systems:

    cbas\samples\local\logs

In the logs folder, the following 3 log files are created:
  • cc.log - cluster controller
  • blue-service.log - blue node
  • red-service.log - red node

Analytics is a parallel distributed query processing framework. In this demo environment, there are two nodes named red and blue that each maintain a separate log.

Reporting an Issue

Good bug reports save a lot of time for everyone involved. During the developer preview, we suggest that you post your questions and bug reports to the Couchbase Forum. When reporting an issue, please include the following information:
  • Description of the issue
  • Version information: cbashelper install_version or by running the following command:
    Command
    curl http://localhost:8095/analytics/version
    Result
    
    {
        "build.date": "Fri Oct 14 11:14:23 PDT 2016",
        "build.number": "274",
        "build.version": "1.0.0-SNAPSHOT",
        "projects": [
            {
                "name": "asterixdb",
                "revision": "ba35812f40d961382f89a5e711786537cbb6c977",
                "upstream": "master"
            },
            {
                "name": "asterix-opt",
                "revision": "f48b69804172ec586437de10af37e4b542d9d9e1",
                "upstream": "master"
            },
            {
                "name": "build",
                "revision": "91f673b3dac389a5e4cc6f114350677f0f6f7639",
                "upstream": "master"
            }
        ]
    }
  • Steps to reproduce the issue
  • Logs: cc.log, blue-service.log, and red-service.log
  • Cluster configuration by running the following commands:
    curl http://localhost:8095/analytics/cluster/cc/config
    curl http://localhost:8095/analytics/cluster/blue/config 
    curl http://localhost:8095/analytics/cluster/red/config 
  • Thread dumps by running the following commands:
    curl http://localhost:8095/analytics/cluster/cc/threaddump  
    curl http://localhost:8095/analytics/cluster/blue/threaddump 
    curl http://localhost:8095/analytics/cluster/red/threaddump  

Monitoring the Java Processes

If you run top or a similar tool, you can simply see processes called Java without much information. You can get more information about what is happening in those Java processes by using jps - Java Virtual Machine Process Status Tool. If you aren’t running other Java processes, you can see similar to the following:
$ jps
76993 NCService
76992 NCService
76994 CCDriver
77010 NCDriver
77012 NCDriver
77049 Jps
More details can be obtained by using the -v flag:
$ jps -v
76993 NCService -Djava.util.logging.manager=org.apache.logging.log4j.jul.LogManager -Dapp.name=cbasncservice -Dapp.pid=76993 -Dapp.repo=/Users/will/code/cbas/repo -Dapp.home=/Users/will/code/cbas -Dbasedir=/Users/will/code/cbas
76992 NCService -Djava.util.logging.manager=org.apache.logging.log4j.jul.LogManager -Dapp.name=cbasncservice -Dapp.pid=76992 -Dapp.repo=/Users/will/code/cbas/repo -Dapp.home=/Users/will/code/cbas -Dbasedir=/Users/will/code/cbas
76994 CCDriver -Djava.util.logging.manager=org.apache.logging.log4j.jul.LogManager -Dapp.name=cbascc -Dapp.pid=76994 -Dapp.repo=/Users/will/code/cbas/repo -Dapp.home=/Users/will/code/cbas -Dbasedir=/Users/will/code/cbas
77010 NCDriver -Xmx1536m -Djava.util.logging.manager=org.apache.logging.log4j.jul.LogManager -Dapp.name=cbasnc -Dapp.pid=77010 -Dapp.repo=/Users/will/code/cbas/repo -Dapp.home=/Users/will/code/cbas -Dbasedir=/Users/will/code/cbas
77074 Jps -Dapplication.home=/Library/Java/JavaVirtualMachines/jdk1.8.0_60.jdk/Contents/Home -Xms8m
77012 NCDriver -Xmx1536m -Djava.util.logging.manager=org.apache.logging.log4j.jul.LogManager -Dapp.name=cbasnc -Dapp.pid=77012 -Dapp.repo=/Users/will/code/cbas/repo -Dapp.home=/Users/will/code/cbas -Dbasedir=/Users/will/code/cbas

Sending Feedback

We'd love to hear from you! Feel free to post your feedback to the Couchbase Forum.

FAQs

Q: What’s the relationship between N1QL and SQL++?

SQL++ is a formal language specification with well-defined semantics that was designed with the goal of unifying clean, powerful, declarative query language for handling semi-structured data. The N1QL is the query language used by the Couchbase Server query service, and Couchbase SQL++ is the language used in Analytics.

Q: Can I use this with memcached buckets?

No, Analytics relies on DCP and JSON formatted documents. It can only be used with JSON coming from a Couchbase bucket.

Q: I got an error message like this complaining about types?

In this case, you’ve gotten an error message because you’re trying to apply a function to something that doesn’t have functions. This may be caused by ambiguous identifiers that get resolved to something different from what you intended. You can try to specify the identifier fully to resolve that ambiguity.